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Chapter 1 


Telephony Foundation API 


1.1 References 


[1] Software Architecture Document, Version 1.1 Revision 1.4, LiMo Foundation, 11 September 2007 
[2] High Level Requirements, Version 1.0 Revision 1.5, LiMo Foundation, 22 October 2007 
[3] 3GPP Specification References: 


3GPP TS 24.008 Mobile radio interface Layer 3 specification; Core network protocols; Stage 3 
(Release 5) 


3GPP TS 22.030 Man-Machine Interface (MMI) of the User Equipment (UE) (Release 5) 


3GPP TS 24.080 supplementary services specification (Release 5) 


3GPP TS 23.038 Alphabets and language-specific information (Release 5) 


3GPP TS 23.040 Technical realization of the Short Message Service (SMS) (Release 5) 


3GPP TS 29.002 Mobile Application Part (MAP) specification (Release 5) 


3GPP TS 31.102 Characteristics of the USIM application (Release 5) 


3GPP TS 22.084 MultiParty (MPTY) Supplementary Services - Stage 1 (Release 5) 


3GPP TS 23.014 Support of Dual Tone Multi Frequency (DTMF) signaling (Release 5) 


1.3 Overview 


The Telephony Service provides an abstraction of the mobile network telephony capabilities of a device 
and enables applications to invoke comprehensive and flexible telephony functions in support of their appli- 
cations; e.g. voice call services, video call setup (video call functionality is not supported in the current re- 
lease), supplementary services, call charge information and telephone network registration. The Telephony 
service also provides the telephony related services required by other LiMo Frameworks and components, 
for example APIs for sending/receiving SMS messages, receiving cell broadcast messages for the LiMo 
Messaging Service. 


SIM/UIM access (e.g. read/write of SIM resident data) is closely related to telephony functionality and 
often realized by the same components and therefore this is also included in the Telephony Service ar- 
chitecture. SIM/USIM Application Toolkit provides a mechanism that allows applications resident on the 


2 Telephony Foundation API 


SIM/USIM to interact with the mobile handset applications and components. Support of this functionality 
is not a part of LiMo Release 1 scope, but included as a placeholder for a future release. 


1.21 Execution Model - ТАРІ Client Library and Telephony Server 


The LiMo TAPI client library and LiMo Telephony Server provide the general telephony services and hide 
all low-level details from the application developers. 


1) A Telephony client application loads the LiMo TAPI Client library into its process space and uses TAPI 
to interface with LiMo Telephony Server. 


2) TAPI client application has to register the callback with TAPI Library for handling the telephony events 
(Solicited /Unsolicited events). Registered callback function shall be invoked when events occurs at TAPI 
Library. 


3) LiMo TAPI library establishes the communication link with the LiMo Telephony Server. When an 
application calls a Telephony APIs, the LiMo TAPI library validates and marshals the parameters, then 
forwards the information to the LiMo Telephony Server. 


4) LiMo Telephony Server tracks communications resources available and sends their syn- 
chronous/asynchronous responses to LiMo ТАРІ library. TAPI library passes the 5уп- 
chronous/asynchronous responses or any unsolicited indication in terms of Telephony events to 
TAPI Application directly hiding telephony protocol details. 


5) LiMo TAPI library de-marshals the response from LiMo Telephony Server which is returned syn- 
chronously and returns it to LiMo ТАРТ Application. 


There is only one Telephony Server instance in LiMo R1 which supports multiple simultaneous telephony 
applications. LiMo Telephony frameworks client-server model abstracts the telephony applications from 
protocol and low-level details, which make simple for application developer and helps telephony server 
robust in nature On the other hand, LiMo TAPI already supports radio interfaces GSM/CDMA/3G апа it is 
easy to extend to support various other radio interfaces. 


1.2.2 General Programming Considerations - TAPI Request APIs 


The TAPI library provides APIs for applications to access telephony services. The TAPI library provides 
two types of request functions. These request functions are called by the telephony client applications in 
order to provide basic telephony service to the user. 


* Synchronous requests 


* Asynchronous requests 


1.2.21 Synchronous Request APIs 


The client application process waits until the processing of the request is completed. The Telephony server 
can process some APIs and provide the return response while returning back to the function. The function 
returns with the result of the request (1f any) and any applicable error codes. For example, an application 
may query for call status information on a call or get network registration status information. 
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Application Telephony 
(TAPI Library) Server 


|] Са!! АР! 


-. => =" 
——— 
-- 


Figure 1.1: Synchronous Interface 


1.2.2.2 Asynchronous Request APIs 


In the case of Asynchronous request APIs, the request is provided to the Telephony server and the actual 
confirmation/response to that request will be returned at later time. The Telephony server provides a re- 
sponse to the TAPI library and the TAPI library invokes registered application callback to pass telephony 
events to the application. An illustration of the client application making a call to an asynchronous function 
is provided in the following figure. 


Call API 


е 


Figure 1.2: Asynchronous Interface 


In an asynchronous request: 
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The client application passes parameters related to the service request and also it provides an out 
parameter request id (an unique identifier) for each asynchronous service request which will be filled 
and returned by Telephony server. 


When the function is returned, the return value indicates whether the request was successfully sent 
to the Telephony Server or if failure happened during processing in the Telephony Server. In case of 
a successful API return, a valid RequestId value will be filled and returned to the application. The 
request id parameter value will be set to an invalid value (for e.g., OXFF), when the API fails due to 
some reason. 


When the Telephony server receives the actual completion of service, it sends the results of the 
events to the TAPI library. The TAPI library processes the event received and passes it to Client 
application using the registered callback. The client application shall handle the notification events 
in the registered callback. 


Asynchronous functions can be completed in one or more event notifications. 


For example, In a Call Hold API request, there will be one event notification which will complete the 
asynchronous nature. 


However, in a Call Setup API request, there are many intermediate events during the call including: a 
Connecting Indication event, an Alert Indication event, and a Connected Indication event. Based on the 
event notification and corresponding states, the application can decide whether the request is complete or 
not. 


The Telephony client application has to register the callback with Telephony to receive the event notification 
messages and handle them in its own process. Based on the callback registration, the application callback 
will get invoked for those registered events when the TAPI library receives the indication from Telephony 
server. For example, a call being connected, Alert Indication, or incoming call etc. 


If an application decides to call an asynchronous API and then wait for the API completion notification, 
then the application can be considered to be executing that API in a synchronous fashion. This is allowable. 


RequestId Information: 


The request id is used to uniquely identify an asynchronous service request. All Asynchronous Request 
APIs provide а RequestId as an out parameter. The RequestlId pointer will have a value in the range(0- 
255) returned by Telephony server on processing the API request successfully. If there is a failure in 
ап API request, the RequestlId shall be invalid request id (value = -1) and the function return value will 
indicate an error. 

This RequestId will act as reference for each API request an application originates. An application 
shall receive the RequestId value along with other event data for asynchronous response/Indication 
from TAPI library. The application can clear the RequestId value based on the RequestId and event(s) 
received for the originated request. In the case of unsolicited events, the RequestId parameter passed 
in the notification shall be the invalid request id value which is -1. 


1.2.2.3 TAPI Considerations 


The following conditions need to be followed by TAPI and Applications: 


1. All the input parameters passed in Telephony APIs are validated in TAPI Client library as below: 


(a) Parameters (passed by reference) are validated against Null 


(b) Type defined Enumeration parameters are validated against start and end enumeration values 
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10. 


11. 


(c) TAPI Client library will pass all the requests to Telephony Server after the above considerations 
(a) and (b). 

(d) Telephony server shall validate some parameters based on the information. For example, if an 
invalid call handle is sent in Call API requests, the Telephony server will validate the call handle 
with its existing call related information. If it is not a valid handle, then a TAPI INVALID - 
CALLHANDLE error will be returned from API synchronously in the return value to the client 
application. 


. The Application has to allocate memory for the parameters passed by reference in Telephony API 


calls. The Application shall de-allocate the memory once the API call is completed, successful or 
not. 


. Inthecase of Synchronous APIs, when API has returned with success to the Application, then the out 


parameters' data is valid. Application can process the out parameter data and release if any memory 
is allocated for that out parameter. 


. In the case of Asynchronous APIs, data will be available as soon as application callback is invoked 


for a received telephony event from TAPI library. 


. When an API is processed successfully within Telephony FW, the API return value will be set to 


TAPI API SUCCESS. If there is a failure in processing the request within Telephony server, then 
the API return value may contain any other value than ТАРІ АРІ SUCCESS and the error values 
are defined in section [TapiResult t]. For synchronous APIs out parameters' data is valid when the 
API return value is set to ТАРІ АРІ SUCCESS. 


. If there are errors in processing the request at the OEM Telephony provider or any errors from the 


network, these errors are indicated to the application in Asynchronous notification based on the 
service request. 


. If there is no data associated with an event, then the event data parameter in the TAPI Event structure 


[Tel TapiEvent t] will be NULL when it is passed in the Application callback. 


. The first TAPI request from a TAPI Client will initialize the TAPI Library and Telephony server 


communication. 


. In the case of asynchronous solicited responses, TAPI library filters out the event with request id 


which is not requested by that application. 


Тһе API request may fail with a return error ТАРІ АРІ REQUEST МАХ IN PROGRESS as the 
maximum number of requests for the same service is already in progress in TS/OEM Adaptation 
layer plug-in. 


If an application calls a synchronous API, then it needs to wait until the request is complete (blocked) 
and the response is sent back. But at the same time, The application should be able to process the 
registered callbacks, if any, it has registered for other events. 


1.2.2.4 The Two Common Uses of Asynchronous Requests 


In general, there are 2 cases for Asynchronous interaction between a TAPI application and the Telephony 
Server. 


Casel (Service Requests): A TAPI Application requests the service by calling a TAPI Client Library func- 
tion and then the TAPI Library sends the notification to inform the application of the service result by 
invoking the registered application callback. Making a voice call is such a case. 


The application calls TelTapiCallSetup to request the voice call service, and then it may continue with other 
work. The Telephony server will provide intermediate notifications (Setup indication, Connecting Indica- 
tion, Alert indication etc.) about any changes in call status. Once the call is established, the Telephony 
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server will send the Connected indication to the TAPI Library which will in turn notify the application 
about the status of call (connected or disconnected), the application should handle the processing after that 
point. 


Case2 (Unsolicited Indications): The Telephony server on receiving some unsolicited indications which 
may be due to messages received from the network or from an underlying wireless protocol stack perform- 
ing some periodic functionalities like network search and registration, will inform these indications to the 
application through asynchronous notifications using the TAPI Library. Examples of this case are incoming 
SMS, incoming call, network registration status and network signal change. 


TelAppCallback 


Figure 1.3: Notification Case2 Illustration 


An application has to register the callback for Telephony events with the TAPI Library in order to receive 
the solicited or unsolicited asynchronous notification. Unsolicited notification (case 2) will occur regardless 
whether application uses only synchronous API or only asynchronous API or combination of those. АП 
applications should be able to handle asynchronous unsolicited events. 


1.2.3 Unsolicited Notifications 


When an unsolicited notification is generated by Telephony FW in response to some external event (e.g. 
a signal), it does not directly mean completion or progress of any outstanding request posted by a client 
application. An unsolicited event in general means either change of some state (for example, network 
registration change) or some incoming signal that may be of interest for the application (e.g. an incoming 
call). 


An unsolicited asynchronous notification still has to be handled even if an application uses only syn- 
chronous АРТ. Ап application may choose to ignore unsolicited notifications, however TAPI does not 
provide any other direct way for an application to be informed on telephony related external events. The 
list of unsolicited notifications supported by the Telephony server is captured in Overview2 7. 


1.2.4 Event Notifications 


Telephony applications (i.e. clients) have to register for events which are of its interest according to its 
requirements with the TAPI Library. On receiving an asynchronous response or unsolicited indication, the 
TAPI Library will invoke the callback registered by the telephony client. TAPI event details are detailed in 
TelTapiEvent 1. 
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Applications will register the callback with TAPI Library for Telephony events TAPI library shall invoke 
the registered callback function when the event is received. See the complete list of Telephony events in 
Overview2, 6. 


1.2.5 The TAPI Event Class 


Please refer to TelTapiEventClass t for a complete description of this enumerated list of events. 


Event Class Description 

TAPI CALL VOICE Voice call events 

TAPI CALL DATA Data call events 

TAPI NETTEXT Network Text (SMS and Cell Broadcast) related 
events 

TAPI NETWORK Network related events 

TAPI SS Supplementary Service events 

TAPI SIM Sim related events 

TAPI ERR Error Related events (For debugging purposes 
e.g. Fatal errors at OEM level to be displayed on 
screen ) 

TAPI UTIL Utility events 

TAPI ALL Events pertaining to All Telephony Event Classes 


1.2.6 Telephony Events 


This table explains the list of TAPI events which are passed to an application based on confirma- 
tion/indication event occurring at the TAPI Library. 
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Network Class Events 


TAPI Event Type Description Associated Event Asynchronous 
Data/Payload Response Status 
Structures 

TAPI EVENT - This confirmation TelNetworkInfo t TelNetworkOperation- 
NETWORK - event will be returned Cause t 
SELECT CNF when user manually 

selected a network 

from list for Network 

selection 
TAPI EVENT - This event is returned TelNetworkList t TelNetworkOperation- 
NETWORK - as confirmation for Cause t 
SEARCH CNF manual Network 

search with the 

available network list 
TAPI EVENT - This event is returned TelNetworkSelection- TelNetworkOperation- 
NETWORK - when Get selection Mode t Cause t 
GETSELECTIONMODE mode indication is 
CNF received at TS 
TAPI EVENT - This event is returned TelNetworkInfo t TelNetworkOperation- 
NETWORK - when Get network Cause t 
GETNETWORKINFO 4 information is 
СМЕ requested 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on cancellation of with this event Cause t 
CANCELMANUALSEARfifilual network search 
CNF 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on cancellation of with this event Cause t 
CANCELMANUALSELB@ di @iNnetwork 
CNF selection from network 

list 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on setting network with this event Cause t 
SETNWORDER СМЕ | order 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on setting network with this event Cause_t 
SETNWMODE CNF mode 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on setting network with this event Cause t 
SETSELECTIONMODEH. selection mode 
CNF 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on setting network with this event Cause t 
SETNWBAND CNF band 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on setting network with this event Cause t 
SETSERVICEDOMAIN, service domain 
CNF 
TAPI EVENT - This event is returned No Data associated TelNetworkOperation- 
NETWORK - on setting the network with this event Cause t 
CONFIG. СМЕ configuration 
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RADIO INFO IND 


signal indication 


TAPI EVENT - This event will be TelNetworkInfo t No Status associated 
NETWORK - returned when with this event 
CHANGE IND Telephony server 

receives any indication 

from OEM about 

change in Network 

registra- 

tion/selection/status 
TAPI EVENT - This is unsolicited TelNetworkList t No Status associated 
NETWORK - event indicated when with this event 
SEARCH IND TS receives any 

indication of Manual 

search indication with 

list 
TAPI EVENT - This 1s unsolicited TelNetworkRadio- No Status associated 
NETWORK - event indicating Radio Info t with this event 


NetText Class Events 


DELETE STATUS - 
СМЕ 


indicating the delete 
message e status 


message has been 
deleted 


TAPI Event Type Description Associated Event Asynchronous 
Data/Payload Response Status 
Structures 
TAPI EVENT - This event is returned TelSmsData t TelSmsResponse t 
NETTEXT READ - in response to SMS 
SMS CNF Read message 
TAPI EVENT - This event is returned TelSmsStoredMsg- TelSmsResponse t 
NETTEXT GET - in response to Get CountInfo t 
COUNT CNF Number of messages 
stored in SIM 
TAPI EVENT - This event is returned TelSmsDatapackage- TelSmsResponse t 
NETTEXT - in response to SMS Info t 
SENTSTATUS CNF message sent 
TAPI EVENT - This event is returned TelSmsParams t TelSmsResponse t 
NETTEXT GET - in response to NetText 
PARAM. СМЕ Get parameters 
TAPI EVENT - This confirmation Integer:Sim-index TelSmsResponse t 
NETTEXT - event is a returned from which the 


NETTEXT SET - 
REQUEST CNF 


returned as a 
confirmation for SET 
nettext APIs 


with this event 


TAPI EVENT - This confirmation Integer:Sim-Index in TelSmsResponse t 
NETTEXT SAVE - event is a returned which the message 
STATUS СМЕ indicating the Save stored 
SMS into SIM status 
TAPI EVENT - This event will be No Data associated TelSmsResponse t 


TAPI EVENT - 
NETTEXT GET - 
СВ CONFIG CNF 


This event will be 
returned with Get CB 
configuration details 


TelSmsCbConfig t 


TelSmsResponse t 


TAPI EVENT - 
NETTEXT GET - 
SMSBEARER CNF 


This event is returned 
as a response to get 
preferred bearer used 
for SMS Transport 


TelSmsBearerType t 


TelSmsResponse t 
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TAPI EVENT - This event is returned No Event data TelSmsResponse t 
NETTEXT - in response to send associated with this 
DELIVERY - delivery report event 
REPORT CNF 
TAPI EVENT - This is an unsolicited TelSmsDatapackage- No Status associated 
NETTEXT INCOM - | Incoming SMS Event Info t with this event 
IND 
TAPI EVENT - This is an unsolicited TelSmsCbMsg t No Status associated 
NETTEXT CB - Incoming cell with this event 
INCOM IND broadcast message 
TAPI EVENT - This event is an BOOL (SIM Memory No Status associated 
NETTEXT - unsolicited event is available or not : with this event 
MEMORY, STATUS - | indicating SIM 1:0) 
IND memory status 
Call Class Events 
TAPI Event Type Description Associated Event Asynchronous 
Data/Payload Response Status 
Structures 

TAPI EVENT - This event is returned Integer: Call Handle TelCallCause t 
CALL SETUP CNF as confirmation for 

Call setup 
TAPI EVENT - This event indicates Integer: Call Handle TelCallCause t 
CALL, SEND - the confirmation for 
DTMF CNF sending DTMF Digits 

to the network 
TAPI EVENT - Incoming call was Integer: Call Handle TelCallCause t 
CALL ANSWER - answered 
CNF 
TAPI EVENT - This event indicates Integer: Call Handle TelCallCause t 
CALL RETRIEVE - Call is retrieved from 
CNF held state 
TAPI EVENT - This event indicates is Integer: Call Handle TelCallCause t 
CALL HOLD CNF call is put on hold 
TAPI EVENT - This event indicates is Integer: Call Handle TelCallCause t 
CALL TRANSFER - call is explicitly 
CNF transferred 
TAPI EVENT - This event indicates Integer: Call Handle TelCallCause t 
CALL - that Call is joined in a 
SETUPCONFERENCE |- conference 
CNF 
TAPI EVENT - This event indicates Integer: Call Handle TelCallCause t 
CALL - Call is split from 
SPLITCONFERENCE 4 conference 
CNF 
TAPI EVENT - This event indication Integer: Call Handle No Status associated 
CALL FORWARD - for Call is forwarded with this event 
IND 
TAPI EVENT - This event indicates Integer: Call Handle No Status associated 
CALL ALERT IND the Call is in Alerting with this event 

stage 
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CALL RETRIEVE _ 
IND 


that other party has 
retrieved the call from 
hold 


TAPI EVENT - This event is indicated No Data associated TelCallCause t 
CALL RELEASE - when all the calls with this event 
ALL CNF released requested by 

the application 
TAPI EVENT - This event indicates Integer: Call Handle No Status associated 
CALL - the Call is Connected with this event 
CONNECTED IND 
TAPI EVENT - This event indicates Integer: Call Handle No Status associated 
CALL - the Call is in with this event 
CONNECTING IND Connecting stage 
TAPI EVENT - This event indicates Integer: Call Handle No Status associated 


with this event 


TAPI EVENT - 
CALL HOLD IND 


This event indicates 
that other party is has 
put the call on hold 


Integer: Call Handle 


No Status associated 
with this event 


TAPI EVENT - 
CALL TRANSFER - 
IND 


This event 1s to 
indicate the 
notification of remote 
Explicit Call Transfer 


Integer: Call Handle 


No Status associated 
with this event 


CALL USERINFO - 
IND 


when user-User 
Information(UUS1) 
exchanged during the 
call 


TAPI EVENT - This event is to Integer: Call Handle No Status associated 
CALL - indicate the with this event 
SETUPCONFERENCE |- notification of 
IND invocation of 

Multiparty indication 
TAPI EVENT - This event is to Integer: Call Handle No Status associated 
CALL WAITING. - indicate that Call with this event 
IND waiting indication at 

the remote end 
TAPI EVENT - This event is indicated TelCallUserDataInfo t | No Status associated 


with this event 


TAPI EVENT - 
CALL INCOM IND 


This event indicates 
Incoming Call 
indication to 
Application 


TelCallIncomingCall- 
Info t 


No Status associated 
with this event 


TAPI EVENT - 
CALL END IND 


This event indicates 
the Call is Ended. This 
event can be 
solicited/unsolicited. 
In case of solicited 
events (call release/end 
is explicitly requested 
by Application) then 
valid request id shall 
be present. 

In case of Unsolicited 
events, invalid (-1) is 
passed in the event 


notification 


TelCallEndInfo t 


No Status associated 
with this event 
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Supplementary 
Service Class Events 


TAPI Event Type 


Description 


Associated Event 
Data/Payload 
Structures 


Asynchronous 
Response Status 


TAPI EVENT SS - 
BARRING CNF 


This confirmation 
event is sent when 
Barring 
activation/deactivation 
is requested 


TelSsInfo t 


TelSsCause t 


TAPI EVENT SS - 
GET PASSWORD - 
IND 


This event is indicated 
to the Application 
when network requests 
for Call barring Get 
password for barring 
operation. 


TelSsBarPwdType t 


No Status associated 
with this event 


TAPI EVENT SS - 
BARRING - 
CHANGEPASS CNF 


This event is returned 
as Barring password 
change confirmation 


No Data associated 
with this event 


TelSsCause t 


TAPI EVENT SS - 
BARRING - 
QUERYSTATUS - 
СМЕ 


This event is returned 
as Barring status query 
confirmation 


TelSsInfo t 


TelSsCause t 


TAPI EVENT SS - 
FORWARD CNF 


This event is returned 
as confirmation for 
Forward Activa- 


TelSsInfo t 


tion/Deactivation/Registiation/Erasure 


TelSsCause_t 


TAPI EVENT SS - 
FORWARD - 
QUERYSTATUS - 
СМЕ 


This event is returned 
as confirmation for 
Forward Status query 
confirmation 


TelSsInfo t 


TelSsCause t 


TAPI EVENT SS - 
WAITING. СМЕ 


This event 1s returned 
as confirmation for 
Call waiting 
activation/deactivation 


TelSsInfo t 


TelSsCause t 


TAPI EVENT SS - 


This event is returned 


TelSsInfo t 


TelSsCause t 


WAITING - as Call waiting status 

QUERYSTATUS - query confirmation 

CNF 

TAPI EVENT SS - This event is returned TelSsUssdMsgInfo t TelSsCause t 
USSD CNF as USSD send 


confirmation 


TAPI EVENT SS - 
USSDCNF RSP 


This event is returned 
as USSD confirmation 
response which is sent 
as a response to 
received USSD 


TelSsUssdRespType t 


TelSsCause t 


TAPI EVENT SS - 


This event is an 


TelSsUssdMsgInfo t 


TelSsCause t 


USSDCNF NOTIFY unsolicited USSD 

notification 
TAPI EVENT SS - USSD Indication TelSsUssdRespType t TelSsCause t 
USSD IND RSP Response 
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TAPI EVENT SS - 
VERIFY PWD CNF 


This event is sent when 
verify pwd response is 
sent to Network 


No Data associated 
with this event 


TelSsCause t 


TAPI EVENT SS - 
QUERYCAPABILITY 4 
INFO CNF 


Event associated with 
the interrogation of 
supported 
supplementary services 
at OEM. 


TelSsCapabilityInfo t 


TelSsCause t 


TAPI EVENT SS - 
USSD IND 


This is an unsolicited 
USSD indication 


TelSsUssdMsgInfo t 


No Status associated 
with this event 


TAPI EVENT SS - 
USSD IND NOTIFY 


This event is an 
unsolicited USSD 
notification 


TelSsInfo t 


No Status associated 
with this event 
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SIM Class Events 


TAPI Event Type Description Associated Event Asynchronous 
Data/Payload Response Status 
Structures 

TAPI EVENT SIM - | SIM elementary file TelSimFileInfo. t TelSimAccessResult t 


FILE INFO CNF 


information is returned 


ТАРІ EVENT SIM - 
READ FILE CNF 


This event is returned 
along with Read file 
information 


TelSimReadFileData t 


TelSimAccessResult t 


ТАРІ EVENT SIM - 
UPDATE FILE CNF 


This event is returned 
along with Updated 
file information 


TelSimFileAccess- 
GeneralResp t 


TelSimAccessResult t 


ТАРІ EVENT SIM - | This confirmation TelSimPinInfo t TelSimPinOperation- 
VERIFY PIN CNF event is returned when Result t 

PIN is verified 
ТАРІ EVENT SIM_- | This confirmation TelSimPinInfo t TelSimPinOperation- 
CHANGE PIN. CNF event is returned when Result t 

PIN is changed 
ТАРІ EVENT SIM - | This confirmation TelSimPinInfo t TelSimPinOperation- 
DISABLE PIN. CNF event is returned when Result t 

PIN is disabled 
ТАРІ EVENT SIM - | This confirmation TelSimPinInfo t TelSimPinOperation- 
ENABLE, PIN. CNF event is returned when Result t 

PIN is enabled 
TAPI EVENT . This confirmation TelSimPinInfo t TelSimPinOperation- 
SIM, UNBLOCK - event is returned on Result t 
PIN. CNF unblock PIN request 
ТАРІ EVENT SIM - | This event will be No Data associated TelSimPinOperation- 
ENABLE FDN CNF returned when FDN is with this event Result t 

enabled 
TAPI EVENT SIM - | This event will be No Data associated TelSimPinOperation- 
DISABLE FDN CNF | returned when FDN is with this event Result t 

disabled 
ТАРІ EVENT SIM - | This event is notified TelSimPbStorage- TelSimPbAccess- 
PB STORAGE - for 2G Phone book Info t Result t 
COUNT CNF storage count query 
TAPI EVENT . Phone book entry TelSimPbEntryInfo t TelSimPbAccess- 
SIM. PB ENTRY - information Result t 
INFO. CNF 
ТАРТ EVENT . This event is returned TelSimPbReadResp t TelSimPbAccess- 
SIM PB ACCESS - when phone book Result t 
READ CNF entry is read 
ТАРІ EVENT SIM - | This event is returned TelSimPbUpdate- TelSimPbAccess- 
PB_UPDATE_CNF once phonebook Resp_t Result_t 

update is completed 
TAPIEVENT_SIM_- | This event is returned TelSimPbUpdate- TelSimPbAccess- 
PB_DELETE_CNF once phonebook Resp_t Result_t 


record is deleted 
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TAPI EVENT SIM - 
STATUS IND 


This event is sent 
whenever there is a 
change in the SIM 
status. 

Application can call 
GetPinStatus/GetEcc- 
Info/GetICCIDInfo 
APIs based on SIM 
state. 

For example, if Sim 
state is PIN required, 
application can call 
getpinstatus to know 
whether pin/upin is 
enabled/blocked. 


TelSimCardStatus_t 


No Status associated 
with this event 


ТАРІ EVENT SIM - 
FDN STATUS IND 


This event is to 
indicate the whenever 
FDN status is 


changed(disabled/enabled) 


Bool fdn_ status. 
(True: enabled, 
False:disabled) 


No Status associated 
with this event 


Error Class Events 


TAPI Event Type 


Description 


Associated Event 
Data/Payload 
Structures 


Asynchronous 
Response Status 


TAPI EVENT ERR - 
RESERVED] IND 


This event is notified to 
application about some 
error has occurred at 
OEM and can be used 
for debugging purpose 


TelTapiErrorInfo t 


No Status associated 
with this event 


TAPI EVENT ERR - 
RESERVED2 IND 


This event is notified to 
application about some 
error has occurred at 
OEM and can be used 
for debugging purpose 


TelTapiErrorInfo t 


No Status associated 
with this event 


TAPI EVENT ERR - 
RESERVED3 IND 


This event is notified to 
application about some 
error has occurred at 
OEM and can be used 
for debugging purpose 


TelTapiErrorInfo t 


No Status associated 
with this event 


TAPI EVENT ERR - 
КЕЅЕКУЕР4 IND 


This event is notified to 
application about some 
error has occurred at 
OEM and can be used 
for debugging purpose 


TelTapiErrorInfo t 


No Status associated 
with this event 


TAPI EVENT ERR - 
RESERVED5 IND 


This event is notified to 
application about some 
error has occurred at 
OEM and can be used 
for debugging purpose 


TelTapiErrorInfo t 


No Status associated 
with this event 
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TUNNEL INFO CNF | event is returned for 


Tunnel information 


UTILITY Class 

Events 

TAPI Event Type Description Associated Event Asynchronous 
Data/Payload Response Status 
Structures 

TAPI EVENT - This confirmation TelTapiTunnelInfo t Tunnel status is a 


Boolean. 

Success (1-True) or 
Failure (0-False) 
indicates asynchronous 
return 


TAPI EVENT - 
TUNNEL INFO IND 


This event 15 an 
unsolicited event 
informing about 
Tunnel information 


No Status associated 
with this event 


TelTapiTunnelInfo t 


1.2.7 Mapping of LiMo Event Ids and Unsolicited TAPI Events 


The table below indicates the unsolicited TAPI events and their corresponding LiMo event ids. Some of 


these event ids can be used for auto-launch purposes. 


LiMo Telephony Event Ids 


TAPI Event 


Telephony.Network.ChangeInd 


TAPI EVENT NETWORK CHANGE IND 


Telephony.Network.SearchInd 


TAPI EVENT NETWORK SEARCH IND 


Telephony.Network.RadioinfoInd 


TAPI EVENT NETWORK RADIO INFO - 
IND 


Telephony.Nettext.IncomingInd 


TAPI EVENT NETTEXT INCOM IND 


Telephony.Nettext. CbIncomingInd 


TAPI EVENT NETTEXT CB INCOM IND 


Telephony.Nettext. MemoryStatusInd 


TAPI EVENT NETTEXT MEMORY - 
STATUS IND 


Telephony.Call.Voice.IncomingInd 


TAPI EVENT CALL INCOM IND 


Telephony.Ss.UssdInd 


TAPI EVENT SS USSD IND 


Telephony.Ss.UssdIndNotify 


TAPI EVENT SS USSD IND NOTIFY 


Telephony.Sim.SimStatusInd 


TAPI EVENT SIM STATUS IND 


Telephony.Sim.FdnStatusInd 


TAPI EVENT SIM FDN STATUS IND 


Telephony.Err.ErrInd1 ТАРІ EVENT ERR RESERVEDI IND 
Telephony.Err.ErrInd2 TAPI EVENT ERR RESERVED2 IND 
Telephony.Err.ErrInd3 ТАРІ EVENT ERR RESERVED? IND 
Telephony.Err.ErrInd4 ТАРІ EVENT ERR RESERVED4 IND 
Telephony.Err.ErrInd5 ТАРІ EVENT ERR RESERVED5 IND 


Telephony. Util. TunnelInfoInd 


TAPI EVENT TUNNEL INFO IND 


1.3 Industry Standard 


None 


1.4 External API Documents 


None 
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1.5 Plug-in Extension Point Interface 


None 


1.6 Other Interfaces 


None 


1.7 Other Notes 


None 
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Module Index 


2.1 Modules 


Here is a list of all modules: 


CallServices sds uu oki ale kee кё се Шалы nep RR Ы Ы en ee medios 27 
TelTapiCallÓSetup ........................................ 28 
TelTapiCallAnswer ....................................... 30 
TelTapiCallRelease sose 2229 oom mo oe Ro om x Oe Ry o eom жок en 32 
TelTapiCallReleaseAll 2.2.2.2....2........:................... 23 
TelTapiCallSendDTMF ..................................... 35 
TelTapiCallRetrieve- ise o RR om жок ЖЕ Ee WOREOCK EDS ROS жж ыр 37 
TelTapicalHold s м. ж ek ава o ааа E Жы el ee аль қ Ы E eos 38 
TelTapiCallJomg ee sho o mom ARR Rok Rom фы E ey 4 4 м Ы 39 
TelTapiCallS plit „эш жюк + xs REOR Remo mock oW BOR OE oO E AUT RR e RA 41 
TelTapiCallExplicitTransfer . . . . lere 43 
TelMapiCallGetStatus: otee ek oso mop OR BR E л Ro X OE a кж Ык бы 6 S 45 
TelTapiCallGetDuration . . . . ooo re 46 
TelTapiCallGetConferenceList ................................. 47 

Ме ехібетуісеб, 4.022554 и tens озы дк кр кк EER Ee EES 49 
TelTapiSmsSend ; 22-225 Мек Paw bees be ee E ee ee RUE RE ORO 50 
TelTapiSmsRead. ==. ROS bbb Pob 05 жж LS ede те Se HE аса 52 
TelTapiSms Write: oc beoe ee o р жок oe e VOX GE X Ye ee c] ge eel 54 
TelTapiSms Б АГ саат таны 56 
TelTapiSmsGetCount ...................................... 57 
TelTapiSmsCBSetConfig .................................... 58 
TelTapiSmsCBGetConfig .................................... 60 
TelFapiSmsSetSC A deck sooo Eo әже ee е жаса 61 
ТеІ!ТарібтвСе5СА....................................... 62 
TelTapiSmsSetPreferredBearer 2................................ 63 
ТеЇТар!15твӊСеїРгеїеттейВеагег................................. 64 
TelTapiSmsGetParameters ................................... 65 
Те!Тарі5тпбе(Рагате(етв.................................... 66 
TelTapiSmsSendDeliveryReport ................................ 68 

ho iu "ED" -"---—-— T 69 
TelTapiNwSetConfiguration ........ eere 70 


TelTapiNwSelectNetwork . >. s: 22e 72 


Module Index 


TelTapiNwCancelManualSearch ................................ 74 
TelTapiNwCancelManualSelection . ......... een a 
TelTapiNwGetNetworkInfo ................................... 76 
TelTapiNwSearchNetwork ......... leere TT 
TelTapiNwSetSelecionMode .................................. 78 
TelTapiNwGetSelecionMode. . . ....... rn 80 
ТеїТар!Му$е!$егусеБоташ.................................. 81 
TelTapiNwSetNetworkOrder .................................. 83 
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Data Structure Index 


3.1 Data Structures 


Here are the data structures with brief descriptions: 
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File Index 


4.1 FileList 


Here is a list of all documented files with brief descriptions: 
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contains a sample set of function prototypes that would be required by applications) . 298 


ITapiNetText.h (This file serves as a "C" header file defines functions for Tapi NetText Services. 
It contains a sample set of function prototypes that would be required by applications ) 300 
ITapiNetwork.h (This file serves as a "C" header file defines functions for Tapi Network. It 


contains a sample set of function prototypes that would be required by applications) . 302 
ITapiSim.h (This file serves as a "C" header file defines functions for Tapi SIM Services. It 
contains a sample set of function prototypes that would be required by applications) . 304 


ITapiSs.h (This file serves as a "C" header file defines functions for Tapi Supplementary Services. 

It contains a sample set of function prototypes that would be required by applications ) 307 
TapiCommon.h (This file serves as a "C" header file defines functions for Tapi Common Inter- 

faces like Callback Registration / De-registration. It contains a sample set of function 


prototypes that would be required by applications) ................... 309 
TelCall.h (This file serves as a "C" header file defines structures for Tapi Call Services. It contains 
a sample set of constants, enums, structs that would be required by applications) ... 312 


TelNetText.h (This file serves as a "C" header file defines structures for Tapi Network Text Ser- 
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applications) 55-52% века жоё жоё жолы RUE RU REGE RR БОБ S Сы ыз 315 
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a sample set of constants, enums,structs that would be required by applications)... . 319 
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sample set of constants, enums,structs that would be required by applications ) . . . .. 324 
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Module Documentation 


5.1 CallServices 


Files 


* file ITapiCall.h 


This file serves as a "C" header file defines functions for Tapi Call Services. 
It contains a sample set of function prototypes that would be required by applications. 


Modules 


TelTapiCallSetup 
TelTapiCallAnswer 

Tel TapiCallRelease 
TelTapiCallReleaseAll 
TelTapiCallSendDTMF 
TelTapiCallRetrieve 
TelTapiCallHold 
TelTapiCallJoin 
TelTapiCallSplit 
TelTapiCallExplicitTransfer 
TelTapiCallGetStatus 
TelTapiCallGetDuration 
TelTapiCallGetConferenceList 
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5.2 TelTapiCallSetup 


Functions 


e TapiResult t TelTapiCallSetup (const TelCallSetupParams t *pParams, unsigned int «pCallHandle, 
int «pRequestId) 


This function originates MO call setup. This is an asynchronous function. The function completes immedi- 
ately and call setup proceeds in background. 


5.21 Function Documentation 


5.2.1.4 TapiResult t TelTapiCallSetup (const TelCallSetupParams t x pParams, unsigned int ж 
pCallHandle, int х pRequestId) 


This function originates MO call setup. This is an asynchronous function. The function completes imme- 
diately and call setup proceeds in background. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


e If call to TelTapiCallSetup() is successful, call handle and request ID are assigned by Telephony 
Server and returned to client by given Call Handle and Request Id parameters. MO call setup 
continues in background. There are multiple states involved in the call setup procedure. Upon 
request completion successful or not, various event notifications are sent to client along with data 
associated with event (Successful data or error information) based on the indication or response 
received at the Telephony Server. 


* Setting up Emergency call 


— when TelCallType t is voice call, voice call is setup unless dial number parameter is an 
emergency number known to telephony FW (like 112 for all 2G and above, other numbers 
may operator specific or device configuration specific, so Telephony FW will read relevant 
SIM files and refer to internal configuration records). If an emergency number is passed and 
TelCallType tis voice call, Telephony FW shall setup emergency phone call. 


— When TelCallType t is emergency call, emergency call is always set up. 


Warning: 
* None. 


Parameters: 


< pParams • TelCallSetupParams t contains the necessary parameters like supplementary infor- 
mation, the type of the call (whether it is a voice call or data call etc), identity mode option 
(Identity to be shown or hidden etc) and the Closed User Group (CUG) information for 
setting up the call. 


— pCallHandle ” Unique handle for referring the call 

— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 
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Async Response Message: 


TAPI EVENT CALL SETUP CNF is sent to the application when the lower layers get the call orig- 
inate response. Asynchronous return status is indicated by TelCallCause t and call handle is sent in 
the event data. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Else it will return failure and error code (Refer TapiResult t) 
Prospective Clients: 


External Apps. 


TeITapiCallSetup 


TapiResult t 
ORIGINATING 


ТАРІ EVENT CAIL CONNECTING, IND CONNECTING 


ALERT 
dication 
ТАРІ EVENT САП. ALERT IND 
TelAppCallBack 
CONNECTED 
ТАРІ EVENT САЦ. CONNECTED IND m 
TelAppCallBack : 
END 
dication 
ТАРІ EVENT СА 
TelAppCallBack 
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5.3  TelTapiCallAnswer 


Functions 


e TapiResult t TelTapiCallAnswer (unsigned int CallHandle, TelCallAnswerType t AnsType, int *p- 
RequestId) 


This function is used to answer the incoming call by accepting or rejecting the call. 


5.3.1 Function Documentation 


5.3.1.1 TapiResult t TelTapiCallAnswer (unsigned int CallHandle, TelCallAnswerType_t AnsType, 
int х pRequestId) 


This function is used to answer the incoming call by accepting or rejecting the call. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


< CallHandle % This is the unique handle for referring the call. This call handle is available to 
Application through incoming call (TAPI EVENT CALL INCOM IND) event. 


< AnsType | * Answer type (answer / reject) 

— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
• The event associated with this request 15 ТАРІ EVENT CALL ANSWER СМЕ. Asynchronous 
return status is indicated by TelCallCause t and call handle is sent in the event data. 


* TAPI EVENT CALL CONNECTED IND / TAPI EVENT CALL END IND event will be 
notified in case of call is accepted/rejected. 


Pre Conditions: 


* Call associated with call handle should be TAPI CALL, STATE INCOM state otherwise the 
API fails and there can be a maximum of 1 existing call. 


Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
ШЕ =] c [7 
server 
Register Callback 


Subscribe to notify 


5 
Subscription INCOMING Call 


accepted indication 
TAPI EVENT CALL INCOM IND 


TelAppCallBack 


TelTapiCallAnswer 
Answer the callrequest 


Answer the call request 


ANSWER CNF 


ТАРІ EVENT САЦ CONNECTED IND / 
TAPI EVENT CALL END IND 


TelAppCallBack 
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5.4 TelTapiCallRelease 


Functions 


e TapiResult t TelTapiCallRelease (unsigned int CallHandle, int pRequestId) 


This function releases the call identified by Call Handle irrespective of call is hold or active state. 


5.41 Function Documentation 
5.4.1.1 TapiResult t TelTapiCallRelease (unsigned int CallHandle, int ж pRequestId) 
This function releases the call identified by Call Handle irrespective of call is hold or active state. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* [n case of MPTY Call handle, Call end event is returned for each call in MPTY. 


Warning: 
* None. 


Parameters: 


< CallHandle • Unique handle for referring the call. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


* The event associated with this request is TAPI EVENT CALL END IND and the associated 
data is TelCallEndInfo t. Asynchronous return status is indicated by TelCallCause t. 


Pre Conditions: 


* Call handle should be valid and there should be an existing call in Active/hold state. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.5 Tel'TapiCallReleaseAll 


Functions 


е TapiResult t TelTapiCallReleaseAll (int »pRequestId) 


This function releases the all the calls irrespective of the call is hold or active state. Due to this API request, 
lower layers will release the call and END Indication Event will be sent to all the Applications. 


5.5.1 Function Documentation 
5.5.1.4 TapiResult t TelTapiCallReleaseAIl (int жрКедиев а) 


This function releases the all the calls irrespective of the call is hold or active state. Due to this API request, 
lower layers will release the call and END Indication Event will be sent to all the Applications. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


* This asynchronous event is received for each call getting released. The event associated with this 
request is ТАРІ EVENT CALL ЕМ” IND and the associated data is TelCallEndInfo t. There 
will be no request id present associated with this TAPI EVENT CALL END IND when this 
API is called. Once all the calls are released, Telephony server will indicate application through 
TAPI Library by sending ТАРІ EVENT CALL RELEASE ALL СМЕ. Asynchronous return 
status is indicated by TelCallCause t and there is no associated event data. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.6 TelTapiCallSendDTMF 


Functions 


• TapiResult t TelTapiCallSendDTMF (const char *pDtmfString, int «pRequestId) 


This function sends one or more DTMF digits during the call. 


5.6.1 Function Documentation 
5.6.1.1 TapiResult t TelTapiCallSendDTME (const char « pDtmfString, int x pRequestlId) 


This function sends one or more DTMF digits during the call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


-There will be a single asynchronous notification for all the dtmf digits sent. If the users of this API 
need an asynchronous response for each DTMF digit then User has to call this API multiple times 
passing each single dtmf digit in pDtmfString. 


Warning: 


* None. 


Parameters: 
< pDtmfString • A Null terminated DTMF string to be sent from MS. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


e The event associated with this request is ТАРІ EVENT CALL SEND DTMF СМЕ Asyn- 
chronous return status is indicated by TelCallCause t and call handle is sent in the event data. 


Pre Conditions: 


* Active call should be present. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 
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Prospective Clients: 


External Apps. 
Ea 
TelTapiCalSendDTMF 


dini request #1 


dtmf request #1 


dtmf response 


ТАРІ EVENT CALL SEND DTMF_CNF 
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5.7 TelTapiCallRetrieve 


Functions 


e TapiResult t TelTapiCallRetrieve (unsigned int CallHandle, int *pRequestId) 
This function retrieves the held call. The call identified by Call Handle must be in held state. 


5.7.4 Function Documentation 
5.7.4.4 TapiResult t TelTapiCallRetrieve (unsigned int CallHandle, int x pRequestId) 
This function retrieves the held call. The call identified by Call Handle must be in held state. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* Call duration for the call will be calculated from the moment call has been connected until call is 
released. 


Warning: 
* None. 


Parameters: 


< CallHandle • Unique handle for referring the call. 

— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


* The event associated with this request is TAPI EVENT CALL RETRIEVE CNF. Asyn- 
chronous return status is indicated by TelCallCause t and call handle is sent in the event data. 


Pre Conditions: 


* Call should be in held state in order to retrieve into active state and no active call present. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


38 Module Documentation 


5.8 TelTapiCallHold 


Functions 


e TapiResult t TelTapiCallHold (unsigned int CallHandle, int *pRequestId) 
This function puts the given call on hold. The call identified by Call Handle should be in active state. 


5.8. Function Documentation 
5.8.1.1 TapiResult t TelTapiCallHold (unsigned int CallHandle, int ж pRequestId) 
This function puts the given call on hold. The call identified by Call Handle should be in active state. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 
* Call duration for the call will be calculated from the time call has been connected until call is 
released, i.e. Time duration during the call on hold will also be counted. 
Warning: 
* None. 


Parameters: 


< CallHandle • Unique handle for referring the call. 

— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


• The event associated with this request is ТАРІ EVENT CALL HOLD СМЕ. Asynchronous re- 
turn status is indicated by TelCallCause t and call handle is sent in the event data. 


Pre Conditions: 


* The call identified by the Call Handle should be in active state. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.9 TelTapiCallJoin 


Functions 


e TapiResult t Tel TapiCallJoin (unsigned int CallHandlel, unsigned int CallHandle2, int «pRequest- 
Id) 


This function joins the given two calls (one call in active conversation state and other call in held state) into 
conference. 


5.91 Function Documentation 


5.9.1.1 TapiResult t TelTapiCallJoin (unsigned int CallHandle1, unsigned int CallHandle2, int ж 
pRequestlId) 


This function joins the given two calls (one call in active conversation state and other call in held state) into 
conference. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* Call handle of an active call or held call will be made as MPTY-id, and the other call handle will 
join in a conference). 


Warning: 


* None. 


Parameters: 
< CallHandlel | * The unique handle can be either an active call or held call. 
< CallHandle2 | * Unique call handle. 
— pRequestId  * Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


* The event associated with this request is TAPI EVENT CALL SETUPCONFERENCE CNF. 
Asynchronous return status is indicated by TelCallCause t and call handle of the MPTY call is 
sent in the event data. 


Pre Conditions: 
* For a Multiparty call or for joining two calls into conference, there should be one call in active 
state and another call in held state. 
Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.10 TelTapiCallSplit 


Functions 


e TapiResult t TelTapiCallSplit (unsigned int CallHandle, int «pRequestId) 


This function triggers to splits a private call from multiparty call. This API allows creating a private 
communication with one of remote parties in a multiparty session. TAPI client application has to pass the 
call handle which needs to split from the multiparty call. 


5.10.1 Function Documentation 
5.10.1.1 TapiResult_t TelTapiCallSplit (unsigned int CallHandle, int х pRequestId) 


This function triggers to splits a private call from multiparty call. This API allows creating a private 
communication with one of remote parties in a multiparty session. TAPI client application has to pass the 
call handle which needs to split from the multiparty call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* The list of call handles present in the conference call is retrieved using TelTapiCallGet- 
ConferenceList API 
Warning: 


* None. 


Parameters: 
< CallHandle ^ * handle of call to be made private. Call handle referring to the call that is to be 
split from the conference (call to be made private). 
— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


* The event associated with this request is TAPI EVENT CALL SPLITCONFERENCE CNF. 
Asynchronous return status is indicated by TelCallCause t and call handle for the split call is 
sent in the event data. 


Pre Conditions: 


* Call should be in multiparty conference call. 


Post Conditions: 


* Split call will be the active call and the conference will be held call. 


Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.11  TelTapiCallExplicitTransfer 


Functions 


e TapiResult t TelTapiCallExplicitTransfer (unsigned int CallHandle, int *pRequestId) 


This function triggers to do an explicit call transfer by connecting the two parties where in one party being 
active (active state) and another party being held (held state). 


5.11.1 Function Documentation 
5.11.11 TapiResult t TelTapiCallExplicitTransfer (unsigned int CallHandle, int x pRequestId) 


This function triggers to do an explicit call transfer by connecting the two parties where in one party being 
active (active state) and another party being held (held state). 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


< CallHandle • Call handle of an active call. 

— pRequestId — * Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


* The event associated with this request is TAPI EVENT CALL TRANSFER СМЕ Asyn- 
chronous return status is indicated by TelCallCause t and call handle is sent in the event data. 
Call handle in event data is active call handle which is used in the TelTapiCallExplicitTransfer 
request. 


Pre Conditions: 
* [n order to call transfer, Served mobile subscriber should have 2 calls in one in active state and 
another one Call in Held state. 
Post Conditions: 
* When the request has been completed successfully, Call end indication will be sent to both the 
calls (active and held). 
Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.12 TelTapiCallGetStatus 


Functions 


* TapiResult t TelTapiCallGetStatus (unsigned int CallHandle, TelCallStatus t *pCallStatus) 


This function gets status for the current call identified by Call Handle whenever application wants the call 
status. Call handle must be valid. 


5.12.1 Function Documentation 


5.12.11 TapiResult t TelTapiCallGetStatus (unsigned int CallHandle, TelCallStatus (ж 
pCallStatus) 


This function gets status for the current call identified by Call Handle whenever application wants the call 
status. Call handle must be valid. 


Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< CallHandle — * Unique handle for referring the call. 


— pCallStatus • Call status information like destination number, call direction (MO or МТ), call 
type (voice or data etc), whether the call is in conference state or not, present call state etc 
are returned through this parameter. 


Async Response Message: 
* None. 

Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.13 TelTapiCallGetDuration 


Functions 


e TapiResult t TelTapiCallGetDuration (unsigned int CallHandle, unsigned int «pDurationInSecs) 


This function gets duration of the given call. This is a synchronous function. Duration is accounted from 
the moment the connection is established, i.e. call goes into active state for first time. 


5.13.1 Function Documentation 


5.13.11 TapiResult t TelTapiCallGetDuration (unsigned int CallHandle, unsigned int ж 
pDurationInSecs) 


This function gets duration of the given call. This is a synchronous function. Duration is accounted from 
the moment the connection is established, i.e. call goes into active state for first time. 


Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< CallHandle • Unique handle for referring the call. 


— pDurationInSecs • The total call duration in seconds from the call connecting time to the 
present time is returned through this parameter. 


Async Response Message: 
* None. 

Pre Conditions: 
* None. 

Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.14 TelTapiCallGetConferenceList 


Functions 


e TapiResult t TelTapiCallGetConferenceList (unsigned int CallHandle, unsigned int *pCallList, int 
*pNoOfCalls) 


This is a synchronous function returns all call handles within the given conference call. 


5.14.1 Function Documentation 


5.14.1.1 TapiResult t TelTapiCallGetConferenceList (unsigned int CallHandle, unsigned int ж 
pCallList, int х pNoOfCalls) 


This is a synchronous function returns all call handles within the given conference call. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* Call should be a Multi-party conference call in order to return actual no of calls and call handles 
in the conference calls. 
Warning: 


* None. 


Parameters: 
< CallHandle • Handle of call which is associated with the conference. 


— pCallList œ list of call joined in the conference call. In case there is no active conference. The 
list will be zero and number of calls parameter value will also be zero. Maximum number 
of calls in a conference can be upto 5 (Based on 3GPP TS 22.084). Memory allocation for 
calllist is integer array of size 5. 


— pNoOfCalls • Number of the calls present in conference. 


Async Response Message: 


-None. 


Pre Conditions: 


-None. 


Post Conditions: 


-None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.15 NetTextServices 


Files 


* file ITapiNetText.h 
This file serves as a "C" header file defines functions for Tapi NetText Services. 


It contains a sample set of function prototypes that would be required by applications. 


Modules 


Tel TapiS msSend 
TelTapiSmsRead 
TelTapiSmsWrite 
TelTapiSmsDelete 
TelTapiSmsGetCount 
TelTapiSmsCBSetConfig 
TelTapiSmsCBGetConfig 
TelTapiSmsSetSCA 
TelTapiSmsGetSCA 
TelTapiSmsSetPreferredBearer 
TelTapiSmsGetPreferredBearer 
TelTapiSmsGetParameters 
TelTapiSmsSetParameters 
TelTapiSmsSendDeliveryReport 
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5.16 TelTapiSmsSend 


Functions 


e TapiResult t TelTapiSmsSend (const TelSmsDatapackageInfo_t *pDataPackage, BOOL bMore- 
MsgToSend, int «pRequestId) 


This API is used to send an SMS message to the network. This API interface allows transmitting SMS PDU 
as defined by 3GPP TS 23.040 (SMS-SUBMIT, SMS-COMMAND) to lower layers. This API allows keeping 
the dedicated link at lower layers by passing information as more messages to send in parameters. This will 
enable not to release if a dedicated connection is used for transmission. 


5.16.1 Function Documentation 


5.16.1.1 TapiResult t TelTapiSmsSend (const Tel8msDatapackageInfo t x pDataPackage, BOOL 
bMoreMsgToSend, int x pRequestlId) 


This API is used to send an SMS message to the network. This API interface allows transmitting SMS 
PDU as defined by 3GPP TS 23.040 (SMS-SUBMIT, SMS-COMMAND) to lower layers. This API allows 
keeping the dedicated link at lower layers by passing information as more messages to send in parameters. 
This will enable not to release if a dedicated connection is used for transmission. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pDataPackage • Contains SMS-SUBMIT ТРОП 


< bMoreMsgToSend • will be set to TRUE when there are more than one message to be send or 
Multiple segmented concatenated message to be send, otherwise FALSE. This flag indicates 
OEM that more messages to send. 
— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


SMS sent status is returned in this event TAPI EVENT NETTEXT SENTSTATUS CNF and the 
event data associated with this event is Tel8msDatapackageInfo t. Asynchronous return status is indi- 
cated by TelSmsResponse t. 


Pre Conditions: 


* SMS Preferred bearer has to be set using TelTapiSmsSetPreferredBearer API if there is any pref- 
erence from User. Otherwise default preferred bearer (This will be set by Vendor based on 
operator preference/support) will be used. 
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Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.17 TelTapiSmsRead 


Functions 


e TapiResult t TelTapiSmsRead (int Index, int «pRequestId) 


This function reads a message from SIM card storage. SIM index (index used when storing the SMS) number 
to be passed to in order to read particular SMS message. Total number of messages can be retrieved by Tel- 
TapiSmsGetCount function. 


5.17.1 Function Documentation 
5.17.11  TapiResult t TelTapiSmsRead (int Index, int x pRequestId) 


This function reads a message from SIM card storage. SIM index (index used when storing the SMS) 
number to be passed to in order to read particular SMS message. Total number of messages can be retrieved 
by Tel TapiSmsGetCount function. 

Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


< Index • Index number of the message to be read 

— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
* -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT NETTEXT READ SMS СМЕ and the event data is TelSms- 
Data t. Asynchronous return status is indicated by TelSmsResponse t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
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* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.18 TelTapiSmsWrite 


Functions 


е TapiResult t TelTapiSmsWrite (TelSmsMsgStatus_t MsgStatus, const TelSmsDatapackagelInfo - 
t xpDataPackage, int »pRequestId) 


This function writes a message to SIM storage area. 


5.18.1 Function Documentation 


5.18.1.1  TapiResult t TelTapiSmsWrite (Tel8msMsgStatus t MsgStatus, const 
TelSmsDatapackageInfo t x pDataPackage, int ж pRequestId) 


This function writes a message to SIM storage area. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 
< MsgStatus • Message status information 
< pDataPackage • SMS message structure. 


— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


TAPI library will send TAPI EVENT NETTEXT SAVE STATUS CNF asynchronous event for this 
request when received from TS. The associated data is Sim Index in which the message stored. Asyn- 
chronous return status is indicated by TelSmsResponse t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.19 TelTapiSmsDelete 


Functions 


e TapiResult t TelTapiSmsDelete (signed short Index, int *pRequestId) 


This function deletes a message specified by index (SIM index used when storing the sms) number from the 
SIM storage area. 


5.19.1 Function Documentation 
5.19.1.1 ТаріКеѕи t TelTapiSmsDelete (signed short Index, int x pRequestId) 


This function deletes a message specified by index (SIM index used when storing the sms) number from 
the SIM storage area. 


Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< Index | * Message index to delete. 

— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The asynchronous event associated is TAPI EVENT NETTEXT DELETE STATUS CNF and the 
event data is Sim index from which the message has been deleted. Asynchronous return status is 
indicated by TelSmsResponse t. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Else it will return failure and error code (Refer TapiResult t). 


Prospective Clients: 


External Apps. 
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5.20 TelTapiSmsGetCount 


Functions 


• TapiResult t TelTapiSmsGetCount (int *pRequestId) 


This function is used to retrieve message count information like Total record count, used record count and 
the indices list for SIM Storage. This is an asynchronous function and the response will be sent back by 
event notification. 


5.20.1 Function Documentation 
5.20.1.4  TapiResult t TelTapiSmsGetCount (int x pRequestlId) 


This function is used to retrieve message count information like Total record count, used record count and 
the indices list for SIM Storage. This is an asynchronous function and the response will be sent back by 
event notification. 


Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETTEXT GET COUNT CNEF and the event data is TelSms- 
StoredMsgCountInfo t. Asynchronous return status is indicated by TelSmsResponse t. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


* External Apps. 
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5.21 TelTapiSmsCBSetConfig 


Functions 


e TapiResult t TelTapismsCBSetConfig (const TelSmsCbConfig_t *pCBConfig, int *pRequestld) 


This function is used to set SMS CB Message Identifiers in the appropriate EF-CBMI/EF-CBMIR file in 
(U)SIM. This function also indicates underlying provider to enable or disable CB Channel on which CB 
messages are received. 


§.21.1 Function Documentation 


5.21.1.1 TapiResult t TelTapiSmsCBSetConfig (const TelSmsCbConfig_t x pCBConfig, int ж 
pRequestlId) 


This function is used to set SMS CB Message Identifiers in the appropriate EF-CBMI/EF-CBMIR file in 
(U)SIM. This function also indicates underlying provider to enable or disable CB Channel on which CB 
messages are received. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pCBConfig • This structure contains parameters to set SMS CB configuration 
(i) Cell broadcast service state. (Enabled/disabled.) 
(ii) Cell broadcast message identifier, which denotes whether all cell broadcast message 
identifiers are selected or only some of those. 
(iii) The list count of message identifiers to be set. 
(iv) The actual list of message identifiers to be set. Each identifier occupies 2 bytes. And the 
list ranges from 0x00 to Oxff. 
These message identifiers denote the source and type of the cb message. Based on the 
message identifiers set in the SIM, the ME receives CB messages with selected message 
identifiers. 
— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is TAPI EVENT NETTEXT SET REQUEST CNF and there is no data asso- 
ciated with this event. Asynchronous return status is indicated by TelSmsResponse t. 

Pre Conditions: 


* None. 
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Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.22 TelTapiSmsCBGetConfig 


Functions 


е TapiResult t TelTapismsCBGetConfig (int «xpRequestId) 
This function is used to retrieve SMS CB configuration options from EFcbmi file in the SIM. 


5.22.1 Function Documentation 
5.22.1.4 TapiResult t TelTapiSmsCBGetConfig (int жрКедиев а) 
This function is used to retrieve SMS CB configuration options from EFcbmi file in the SIM. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 
* None. 


Parameters: 
— pRequestId — * Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated is ТАРІ EVENT NETTEXT GET СВ CONFIG СМЕ and the event data is 
TelSmsCbConfig t. Asynchronous return status is indicated by TelSmsResponse t. 
Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


* External Apps. 
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5.23 TelTapiSmsSetSCA 


Functions 


e TapiResult t TelTapiSmsSetSCA (const Tel$8msAddressInfo t жр5СА, int »pRequestId) 


This function is used to set SMS Service Centre Address information in order to send the SMS. 


5.23.1 Function Documentation 
5.23.11  TapiResult t TelTapiSmsSetSCA (const TelSmsAddressInfo t x pSCA, int * pRequestId) 


This function is used to set SMS Service Centre Address information in order to send the SMS. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* This API updates/sets service center address in Efsmsp file in the SIM storage. 


Warning: 
* None. 


Parameters: 
< pSCA  * Contains the service centre address informations. 
— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated is TAPI EVENT NETTEXT SET REQUEST CNF and there is no data asso- 
ciated with this event. Asynchronous return status is indicated by TelSmsResponse t. 
Pre Conditions: 


* None. 
Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t). 


Prospective Clients: 


External Apps. 
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5.24 TelTapiSmsGetSCA 


Functions 


e TapiResult t TelTapismsGetSCA (TelSmsAddressInfo t *pSCA) 


This function is used to get current SMS Service Centre Address information. 


524.1 Function Documentation 
5.24.1.1 TapiResult t TelTapiSmsGetSCA (TelSmsAddressInfo t x pSCA) 
This function is used to get current SMS Service Centre Address information. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


—pSCA • Contains the service centre address information received from the modem. 


Async Response Message: 
None. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.25 TelTapiSmsSetPreferredBearer 


Functions 


e TapiResult t TelTapiSmsSetPreferredBearer (TelSmsBearerType t BearerType, int «pRequestId) 
This function is used to set SMS preferred bearer on which SMS has to be transmitted. 


5.25.1 Function Documentation 


5.25.11  TapiResult t TelTapiSmsSetPreferredBearer (TelSmsBearerType_t BearerType, int ж 
pRequestlId) 


This function is used to set SMS preferred bearer on which SMS has to be transmitted. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
< BearerType | * Specifies the bearer type. 
— pRequestId • Unique identifier for a particular request. 
е pRequestld value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated is TAPI EVENT NETTEXT SET REQUEST CNF and there is no data asso- 
ciated with this event. Asynchronous return status is indicated by TelS8msResponse t 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


64 Module Documentation 


5.26 TelTapiSmsGetPreferredBearer 


Functions 


e TapiResult t TelTapiSmsGetPreferredBearer (int *pRequestld) 


This function is used to get SMS preferred bearer on which SMS has to be transmitted. This is an asyn- 
chronous function. 


5.26.1 Function Documentation 
5.26.1.1  TapiResult t TelTapiSmsGetPreferredBearer (int « pRequestId) 


This function is used to get SMS preferred bearer on which SMS has to be transmitted. This is an asyn- 
chronous function. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated 15 ТАРІ EVENT NETTEXT GET SMSBEARER СМЕ and the associated 
event data is TelSmsBearerType t. Asynchronous return status is indicated by Tel8msResponse t. 
Pre Conditions: 


* None. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.27 TelTapiSmsGetParameters 


Functions 


e TapiResult t TelTapiSmsGetParameters (const int SmsRecordIndex, int «pRequestId) 


This function is used to get the SMS parameters for a particular SMS (sent/received) based on the SIM index 
where it is stored. This is an asynchronous function. 


5.271 Function Documentation 
5.27.11 TapiResult t TelTapiSmsGetParameters (const int SmsRecordIndex, int ж pRequestId) 


This function is used to get the SMS parameters for a particular SMS (sent/received) based on the SIM 
index where it is stored. This is an asynchronous function. 


Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< SmsRecordIndex | * Sim index where the SMS is stored 
— pRequestId • Unique identifier for a particular request. 
* pRequest Id value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 


The event associated 15 ТАРІ EVENT МЕТТЕХТ GET PARAM СМЕ and the event data is TelSms- 
Params t. Asynchronous return status is indicated by TelSmsResponse t 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.28 TelTapiSmsSetParameters 


Functions 


е TapiResult t TelTapiSmsSetParameters (const TelSmsParams_t SmsSetParameters, int жрКедиеві- 
Id) 


This function is used to set the short message service header parameters which are used in the origination 
of MO messages. 


5.28.1 Function Documentation 


5.28.1.4 TapiResult t TelTapiSmsSetParameters (const Tel8msParams t SmsSetParameters, int ж 
pRequestlId) 


This function is used to set the short message service header parameters which are used in the origination 
of MO messages. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* This API updates/sets SMS Parameters in Efsmsp file in the SIM storage 


Warning: 
* None. 


Parameters: 


— SmsSetParameters * Contains SMS header Parameter information like service center address, 
destination address, validity period, protocol identifier, data coding scheme. 


— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
* -І (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated is TAPI EVENT NETTEXT SET REQUEST CNF and there is no data asso- 
ciated with this event. Asynchronous return status is indicated by TelS8msResponse t 
Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
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* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.29 TelTapiSmsSendDeliveryReport 


Functions 


• TapiResult t TelTapiSmsSendDeliveryReport (const TelSmsDatapackageInfo_t *pDataPackage, int 
xpRequestlId) 


This function is used to send a delivery report for the received incoming SMS to the network. 


5.29.1 Function Documentation 


5.29.1.1  TapiResult t TelTapiSmsSendDeliveryReport (const TelSmsDatapackagelInfo_t х 
pDataPackage, int ж pRequestId) 


This function is used to send a delivery report for the received incoming SMS to the network. 
Sync (or) Async: 
This is a Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pDataPackage • Contains SMS Data package.. 

— pRequestId • Unique identifier for a particular request. 
e pRequestld value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETTEXT DELIVERY REPORT СМЕ and there is no asso- 
ciated event data. Asynchronous return status is indicated by TelSmsResponse_t 


Pre Conditions: 


* SMS-DELIVER REPORT message structure should be in TPDU format as specified by 3GPP 
TS 23.040 SMS TPDU. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.30 NetworkServices 


Files 


* file ITapiNetwork.h 


This file serves as a "C" header file defines functions for Tapi Network. 
It contains a sample set of function prototypes that would be required by applications. 


Modules 


Tel TapiNwSetConfiguration 

Tel TapiNwSelectNetwork 

Tel TapiNwCancelManualSearch 
Tel TapiNwCancelManualSelection 
Tel TapiNwGetNetworkInfo 

Tel TapiNwSearchNetwork 

Tel TapiNwSetSelectionMode 
Tel TapiNwGetSelectionMode 
Tel TapiNwSetServiceDomain 
Tel TapiNwSetNetworkOrder 

Tel TapiNwSetNetworkMode 

Tel TapiNwSetNetworkBand 
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5.31 TelTapiNwSetConfiguration 


Functions 


* TapiResult t TelTapiNwSetConfiguration (const TelNetworkConfigSettings t *pConfigNetwork- 
Info, int «pRequestId) 


This API allows to set the network configuration settings at OEM based on which network registration will 
happen. 


5.31.4 Function Documentation 


5.31.1.1 TapiResult t TelTapiNwSetConfiguration (const TelNetworkConfigSettings t х 
pConfigNetworkInfo, int * pRequestId) 


This API allows to set the network configuration settings at OEM based on which network registration will 
happen. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


< pConfigNetworkInfo | * Contains Network information like network order, mode, service do- 
main, etc. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT NETWORK. CONFIG. СМЕ and there is no event data associ- 
ated with this event and the asynchronous return status is indicated by TelNetworkOperationCause t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
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* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.32 TelTapiNwSelectNetwork 


Functions 


е TapiResult t TelTapiNwSelectNetwork (const TelNetworkS ystemId t *pSystemld, int «pRequest- 
Id) 


This function requests the lower layers to select the network (PLMN) which has been selected by the user 
from the Network List displayed to the User. 


5.32.1 Function Documentation 


5.32.1.1 TapiResult t TelTapiNwSelectNetwork (const TelNetworkSystemlId t х pSystemld, int ж 
pRequestlId) 


This function requests the lower layers to select the network (PLMN) which has been selected by the user 
from the Network List displayed to the User. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
e This function passes the TelNetworkSystemlId t information which is received in Search Network 
Confirmation event. 
Warning: 


* None. 


Parameters: 


< pSystemld % System Id consists systemid format, system type, plmnid and information on 
whether mnc includes pcs digit to identify whether it belongs to 310-xxx plmns or not. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is TAPI EVENT NETWORK, SELECT. CNF and the event data is TelNetwork- 
Info t. Asynchronous return status is indicated by TelNetworkOperationCause t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.33 TelTapiNwCancelManualSearch 


Functions 


e TapiResult t TelTapiNwCancelManualSearch (int «pRequestId) 


This function is called to cancel the triggered manual network search. 


5.33.1 Function Documentation 
5.33.1.1 TapiResult t TelTapiNwCancelManualSearch (int ж pRequestlId) 
This function is called to cancel the triggered manual network search. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK CANCELMANUALSEARCH., СМЕ and there is 
no event data associated with this event and asynchronous return status is indicated by TelNetwork- 
OperationCause t. 

Pre Conditions: 


* Manual network search is already triggered. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.34 TelTapiNwCancelManualSelection 


Functions 


е TapiResult t TelTapiNwCancelManualSelection (int *pRequestld) 


This function is called to cancel manual network selection where user has already selected a network from 
the network list. 


5.34.1 Function Documentation 
5.341.1 TapiResult t TelTapiNwCancelManualSelection (int « pRequestId) 


This function is called to cancel manual network selection where user has already selected a network from 
the network list. 


Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is TAPI EVENT NETWORK CANCELMANUALSELECTION CNF and 
there is no event data associated with this event and asynchronous return status is indicated by Tel- 
NetworkOperationCause t. 


Pre Conditions: 

* User should have selected a network from available network list. 
Post Conditions: 

* None. 
Returns: 


Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.35 TelTapiNwGetNetworkInfo 


Functions 


е TapiResult t TelTapiNwGetNetworkInfo (int «pRequestId) 


This function provides an option to get the current network registration status information. 


5.35.1 Function Documentation 
5.35.1.1 TapiResult t TelTapiNwGetNetworkInfo (int x pRequestlId) 
This function provides an option to get the current network registration status information. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pRequestId  * Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is TAPI EVENT NETWORK. GETNETWORKINFO СМЕ and the event data 
is TelNetworkInfo t. Asynchronous return status is indicated by TelNetworkOperationCause t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.36 TelTapiNwSearchNetwork 


Functions 


e TapiResult t TelTapiNwSearchNetwork (int »pRequestId) 


This function sends a request to do manual network selection to search for the available networks and 
provide the Network List to the User/Application. 


5.36.1 Function Documentation 
5.36.1.1 ТаріКевші t TelTapiNwSearchNetwork (int « pRequestId) 


This function sends a request to do manual network selection to search for the available networks and 
provide the Network List to the User/Application. 


Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK. SEARCH СМЕ and the event data is Tel- 
NetworkList t. Asynchronous return status is indicated by TelNetworkOperationCause t. 


Pre Conditions: 


* TelTapiNwSetSelectionMode API is called prior to this API with TelNetworkSelectionMode t 
as TAPI NETWORK SELECTIONMODE MANUAL. 


Post Conditions: 


* [n the available network list, user can select one of the networks successfully. 


Returns: 


Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.37 TelTapiNwSetSelectionMode 


Functions 


* TapiResult t TelTapiNwSetSelectionMode (TelNetworkSelectionMode t NwSelectionMode, int *р- 
RequestId) 


This function is called when user does Automatic or Manual Network Selection. Request for Automatic 
NW selection or Manual NW selection will allow OEM provider to do PLMN Selection based on network 
selection preference. 


5.37. Function Documentation 


5.37.1.4 TapiResult t TelTapiNwSetSelectionMode (TelNetworkSelectionMode t 
NwSelectionMode, int ж pRequestId) 


This function is called when user does Automatic or Manual Network Selection. Request for Automatic 
NW selection or Manual NW selection will allow OEM provider to do PLMN Selection based on network 
selection preference. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


e If this API is called with Manual Network Selection, then Application shall call TelTapiNw- 
SearchNetwork API to trigger Manual selection so that network list can be provided to the User. 


Warning: 


* None. 


Parameters: 
— NwSelectionMode * Mode of selection i.e. Automatic or Manual 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK, SETSELECTIONMODE СМЕ and there is no 
event data associated with this event and asynchronous return status is indicated by TelNetwork- 
OperationCause t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.38 TelTapiNwGetSelectionMode 


Functions 


e TapiResult t TelTapiNwGetSelectionMode (int «pRequestId) 


This function requests for the present network selection mode i.e. automatic or manual. 


5.38.1 Function Documentation 
5.38.1.4  TapiResult t TelTapiNwGetSelectionMode (int х pRequestId) 
This function requests for the present network selection mode i.e. automatic or manual. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
pRequestld • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK. GETSELECTIONMODE СМЕ and the event 
data is TelNetworkSelectionMode t. Asynchronous return status is indicated by TelNetwork- 
OperationCause t. 

Pre Conditions: 


* None. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.39 TelTapiNwSetServiceDomain 


Functions 


* TapiResult t TelTapiNwSetServiceDomain (TelNetworkServiceDomain t ServiceDomain, int *р- 
RequestId) 


This function is called when User/application wants to configure the service domain to only CS or Only PS 
or Both. This API triggers the underlying protocol stack to do register with Network for only CS services or 
only PS services or both based on the option set using this API. 


5.39.1 Function Documentation 


5.39.1.1 TapiResult t TelTapiNwSetServiceDomain (TelNetworkServiceDomain, t ServiceDomain, 
int x pRequestId) 


This function is called when User/application wants to configure the service domain to only CS or Only PS 
or Both. This API triggers the underlying protocol stack to do register with Network for only CS services 
or only PS services or both based on the option set using this API. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 
Warning: 
* None. 


Parameters: 


ServiceDomain • Specifies the type of Service domain (Packet switch, circuit switch,etc) 
pRequestld • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK. SET SVC DOMAIN. CNF and there is no event 
data associated with this event and asynchronous return status is indicated by TelNetworkOperation- 
Cause t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.40 TelTapiNwSetNetworkOrder 


Functions 


e TapiResult t TelTapiNwSetNetworkOrder (TelNetworkMode t *pPrefNwOrder, int «xpRequestId) 


This API allows lower layers to scan based on preferred network order based options passed. 


5.40.1 Function Documentation 


5.40.1.1  TapiResult t TelTapiNwSetNetworkOrder (TelNetworkMode t x pPrefNwOrder, int ж 
pRequestlId) 


This API allows lower layers to scan based on preferred network order based options passed. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* [f network order list array holds the value "TAPI NETWORK. MODE AUTOMATIC" then 
other following values in the list shall be ignored. 


Warning: 


* None. 


Parameters: 


< pPrefNwOrder — * This parameter is an array of size ТАРІ NW ORDER MAX(which is defined 
as 5) of TelNetworkMode t type specifies the preferred network order for camping. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK SETNWORDER СМЕ and there is no event data 
associated with this event and asynchronous return status is indicated by TelNetworkOperationCause - 
t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.41 TelTapiNwSetNetworkMode 


Functions 


• TapiResult t TelTapiNwSetNetworkMode (TelNetworkMode t NwMode, int »pRequestId) 


This function allows to configure the Network Mode (Automatic, GSM, WCDMA) at OEM provider based 
on which lower layers can scan only those radio access technologies for registering with network. 


5.41.1 Function Documentation 


5.41.1.1 TapiResult t TelTapiNwSetNetworkMode (TelNetworkMode t NwMode, int х 
pRequestlId) 


This function allows to configure the Network Mode (Automatic, GSM, WCDMA) at OEM provider based 
on which lower layers can scan only those radio access technologies for registering with network. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 
< NwMode • Specifies the network mode i.e. Automatic, WCDMA, GSM, CDMA and WLAN. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK. SETNWMODE CNF and there is no event data 
associated with this event and asynchronous return status is indicated by TelNetworkOperationCause - 
Е. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
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* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.42 TelTapiNwSetNetworkBand 


Functions 


• TapiResult t TelTapiNwSetNetworkBand (TelNetworkBandPreferred t BandMode, TelNetwork- 
Band t Band, int *pRequestId) 


This function is invoked to set the network band and allows the underlying OEM provider to scan the set 
band. 


5.421 Function Documentation 


5.42.1.1 TapiResult t TelTapiNwSetNetworkBand (TelNetworkBandPreferred t BandMode, 
TelNetworkBand t Band, int * pRequestlId) 


This function is invoked to set the network band and allows the underlying OEM provider to scan the set 
band. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 
< BandMode_ * Band preference indicates the band provide to be preferred or select the band . 
< Band «© This enumeration defines different network Bands that user can choose. 


— pRequestId • Unique identifier for a particular request. 
* Request Id value can be any value from 0 to 255 if the API is returned successfully 
e -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT NETWORK. SETNWBAND СМЕ and there is no event data 
associated with this event and asynchronous return status is indicated by TelNetworkOperationCause - 
Т. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.43  SIMServices 


Files 


* file ITapiSim.h 


This file serves as a "C" header file defines functions for Tapi SIM Services. 
It contains a sample set of function prototypes that would be required by applications. 


Modules 


TelTapiSimGetFileInfo 
TelTapiSimReadFile 
TelTapiSimUpdateFile 
TelTapiSimVerifyPIN 
TelTapiSimChangePIN 
TelTapiSimDisablePIN 
TelTapiSimEnablePIN 
TelTapiSimUnblockPIN 
TelTapiSimDisableFDN 
TelTapiSimEnableFDN 
TelTapiSimGetDevCtxdata 
TelTapiSimGetlIccIdInfo 

Tel TapiSimGetPINStatus 

Tel TapiSimGetPIN2Status 

Tel TapiSimGetFDNsStatus 
TelTapiSimGetSstInfo 
TelTapiSimGetUstInfo 
TelTapiSimGetImsiInfo 

Tel TapiSimGetEccInfo 
TelTapiSimGetLanguagePrefInfo 
Tel TapiSimGetLanguageIndInfo 
TelTapiSimGetCardType 
TelTapiSimPBGetStorageCount 
TelTapiSimPBGetEntryInfo 
TelTapiSimPBReadRecord 
TelTapiSimPB UpdateRecord 
TelTapiSimPB DeleteRecord 
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5.44 TelTapiSimGetFileInfo 


Functions 


е TapiResult t TelTapiSimGetFileInfo (TelSimFileID t Fileld, int «pRequestId) 


This function is passed to OEM provider in order to fetch the Elementary File info. This functions fetches 
all the Information like Whether EF is present or not, If Present, no of records in EF and EF Data length 
etc. Application can make use this API to know the EF details prior calling SIM Read API. 


5.44.1 Function Documentation 
5.44.1.1 TapiResult t TelTapiSimGetFileInfo (TelSimFileID t Fileld, int * pRequestId) 


This function is passed to OEM provider in order to fetch the Elementary File info. This functions fetches 
all the Information like Whether EF is present or not, If Present, no of records in EF and EF Data length 
etc. Application can make use this API to know the EF details prior calling SIM Read API. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None 


Warning: 


* None. 


Parameters: 


— Fileld -TelSimFileID t is the identifier for elementary files inside SIM. 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is TAPI EVENT. SIM FILE INFO CNF and the event data is TelSimFileInfo - 
t. Asynchronous return status is indicated by TelSimAccessResult t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
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* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.45 "TelTapiSimReadFile 


Functions 


е TapiResult t TelTapiSimReadFile (const TelSimReadFileRequestData t *pReadFileReqData, int 
xpRequestId) 


This function is passed to OEM provider in order to read an elementary file. 


5.45.1 Function Documentation 


5.45.1.1 TapiResult t TelTapiSimReadFile (const TelSimReadFileRequestData t x 
pReadFileReqData, int х pRequestId) 


This function is passed to OEM provider in order to read an elementary file. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None 


Warning: 


* None. 


Parameters: 


— pReadFileReqData -Different parameters like SIM file id to be read, SIM file type, offset for 
reading binary data, record index, the starting index, end index, length of data are passed as 
argument. 

— pRequestId • Unique identifier for a particular request. 

* request id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT. SIM READ FILE СМЕ and the event data is TelSimRead- 
FileData t. Asynchronous return status is indicated by TelSimAccessResult t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.46 TelTapiSimUpdateFile 


Functions 


е TapiResult t TelTapiSimUpdateFile (const TelSimUpdateFileRequestData t *pUpdateFileReqData, 
int xpRequestId) 


This function is passed to OEM provider in-order to update records in an elementary File. 


5.461 Function Documentation 


5.46.1.1 TapiResult t TelTapiSimUpdateFile (const TelSimUpdateFileRequestData t ж 
pUpdateFileReqData, int х pRequestId) 


This function is passed to OEM provider in-order to update records in an elementary File. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pUpdateFileReqData -The information required to update elementary files in SIM is specified 
through this parameter. 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT. SIM UPDATE FILE СМЕ and the event data is TelSimFile- 
AccessGeneralResp t. Asynchronous return status is indicated by TelSimAccessResult t. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.47 TelTapiSimVerifyPIN 


Functions 


e TapiResult t TelTapiSimVerifyPIN (const TelSimPinData t *pPinData, int xpRequestId) 


This function performs PIN verification. This function performs PIN verification based on the pin type 
passed along with pin data. 


5.47.1 Function Documentation 
5.47.11  TapiResult t TelTapiSimVerifyPIN (const TelSimPinData t х pPinData, int x pRequestId) 


This function performs PIN verification. This function performs PIN verification based on the pin type 
passed along with pin data. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* Based on Pin status (PIN/UPIN/PUK) is blocked, an unsolicited event TAPI EVENT. SIM - 
STATUS IND is published to Applications 
Warning: 


* None. 


Parameters: 


— pPinData -PIN code, entered by the user. 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -1 (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT SIM VERIFY PIN CNF and the event data is TelSimPin- 
Info t. Asynchronous return status is indicated by TelSimPinOperationResult t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 
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Prospective Clients: 


External Apps. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.48 TelTapiSimChangePIN 97 


5.48 TelTapiSimChangePIN 


Functions 


e TapiResult t TelTapiSimChangePIN (TelSimPinType t PinType, const char *pOldPinData, const 
char «pNewPinData, int *pRequestld) 


This function changes PIN code based on the pin type passed along with old pin data and new pin data. 


5.48.1 Function Documentation 


5.48.11  TapiResult t TelTapiSimChangePIN (TelSimPinType t PinType, const char ж 
pOldPinData, const char x pNewPinData, int х pRequestId) 


This function changes PIN code based on the pin type passed along with old pin data and new pin data. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* Based on Pin status (PIN/UPIN/PUK) is blocked, an unsolicited event TAPI EVENT. SIM - 
STATUS IND is published to Applications 


Warning: 


* None. 


Parameters: 


— PinType -Pin type information. 
— pOldPinData -Old pin code, entered by the user. (Null terminated string) 
— pNewPinData -New pin code, entered by the user. (Null terminated string) 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is TAPI EVENT. SIM CHANGE PIN CNF and the event data is TelSimPin- 
Info t. Asynchronous return status is indicated by TelSimPinOperationResult t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.49 TelTapiSimDisablePIN 


Functions 


e TapiResult t TelTapiSimDisablePIN (const TelSimPinData t *pPinData, int «pRequestId) 
This function disables the PIN based on the Pin type and pin data passed from Application. 


5.49.1 Function Documentation 


5.49.1111  TapiResult t TelTapiSimDisablePIN (const TelSimPinData t х pPinData, int х 
pRequestlId) 


This function disables the PIN based on the Pin type and pin data passed from Application. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* For PIN2, disabling applies only for 3G USIMs and when PIN2 in NOT mapped to CHV2 of 
GSM application. Based on Pin status (PIN/UPIN/PUK) is blocked, an unsolicited event TAPI - 
EVENT SIM. STATUS IND is published to Applications. 


Warning: 


* None. 


Parameters: 


— pPinData -User entered Pin disable data and pin type 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT. SIM DISABLE РІМ СМЕ and the event data is TelSimPin- 
Info t. Asynchronous return status is indicated by TelSimPinOperationResult t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 
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Prospective Clients: 


External Apps. 
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5.50 TelTapiSimEnablePIN 


Functions 


e TapiResult t TelTapiSimEnablePIN (const TelSimPinData t *pPinData, int *pRequestId) 
This function enables the PIN based on the Pin type and pin data passed from the Application. 


5.50.4 Function Documentation 
5.50.1.1 TapiResult t TelTapiSimEnablePIN (const TelSimPinData t * pPinData, int x pRequestId) 


This function enables the PIN based on the Pin type and pin data passed from the Application. 
Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* For PIN2, disabling applies only for 3G USIMs and when PIN2 in NOT mapped to CHV2 of 
GSM application. Based on Pin status (PIN/UPIN/PUK) is blocked, an unsolicited event TAPI - 
EVENT. SIM, STATUS IND is published to Applications. 


Warning: 
* None. 


Parameters: 


— pPinData -User entered Pin disable data and pin type 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST 1р) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT. SIM ENABLE PIN СМЕ and the event data is TelSimPin- 
Info t. Asynchronous return status is indicated by TelSimPinOperationResult t. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.51 TelTapiSimUnblockPIN 


Functions 


e TapiResult t TelTapiSimUnblockPIN (const TelSimPinData t *pPukPinData, const TelSimPin- 
Data t *pNewPinData, int «pRequestlId) 


This function performs unblock PIN operation based on PUK information passed along with unblock infor- 
mation entered by the user. 


5.51.1 Function Documentation 


5.51.11  TapiResult t TelTapiSimUnblockPIN (const TelSimPinData t x pPukPinData, const 
TelSimPinData t x pNewPinData, int * pRequestId) 


This function performs unblock PIN operation based on PUK information passed along with unblock in- 
formation entered by the user. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* Based on Pin status (PIN/UPIN/PUK) is blocked, an unsolicited event TAPI EVENT. SIM - 
STATUS IND is published to Applications. 
Warning: 


* None. 


Parameters: 


— pPukPinData -Specifies unblocking PIN password 

— pNewPinData -Specifies PIN password. 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT. SIM UNBLOCK. РІМ СМЕ and the event data is TelSimPin- 
Info t. Asynchronous return status is indicated by TelSimPinOperationResult t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.5] TelTapiSimUnblockPIN 103 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.52 TelTapiSimDisableFDN 


Functions 


e TapiResult t TelTapiSimDisableFDN (const char «pPinData, int *pRequestId) 
This function disables FDN. 


5.52. Function Documentation 
5.52.11  TapiResult t TelTapiSimDisableFDN (const char * pPinData, int x pRequestId) 


This function disables FDN. 
Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* An unsolicited event TAPI EVENT. SIM FDN STATUS IND is notified to indicate whenever 
FDN status is changed(disabled/enabled) 


Warning: 
* None. 


Parameters: 
— pPinData -User entered PIN2 data. (NULL terminated string) 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated is ТАРІ EVENT. SIM DISABLE ЕОМ СМЕ and there is no event data associ- 
ated with this event. Asynchronous return status is indicated by TelSimPinOperationResult t. 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.53 TelTapiSimEnableFDN 


Functions 


e TapiResult t TelTapiSimEnableFDN (const char «pPinData, int «pRequestId) 
This function enables FDN. 


5.53.4 Function Documentation 
5.53.1.1 TapiResult t TelTapiSimEnableFDN (const char х pPinData, int х pRequestlId) 


This function enables FDN. 
Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 


* An unsolicited event TAPI EVENT. SIM FDN STATUS IND is notified to indicate whenever 
FDN status is changed(disabled/enabled) 


Warning: 
* None. 


Parameters: 
— pPinData -User entered PIN2 data. (NULL terminated string) 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -І (INVALID REQUEST ID) will be sent in case of failure. 
Async Response Message: 
The event associated is ТАРІ EVENT. SIM ENABLE FDN_CNE and there is no event data associ- 
ated with this event. Asynchronous return status is indicated by TelSimPinOperationResult t. 
Pre Conditions: 
* None. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.54 TelTapiSimGetDevCtxdata 


Functions 


• TapiResult t TelTapiSimGetDevCtxdata (TelSimDeviceContext t *pSimData) 


This function is used to get device context data of SIM. SIM device context data such as PIN Enabled 
status, FDN, BDN Status, IMSI information, ECC, LP, (U)SIM service table information, group identifier 
information will be passed. 


5.541 Function Documentation 
5.54.1.1 TapiResult t TelTapiSimGetDevCtxdata (TelSimDeviceContext t x pSimData) 


This function is used to get device context data of SIM. SIM device context data such as PIN Enabled 
status, FDN, BDN Status, IMSI information, ECC, LP, (U)SIM service table information, group identifier 
information will be passed. 


Sync (or) Async: 
This is a synchronous function. 
Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pSimData TelSimDeviceContext_t contains the requested data, including sst/ust, IMSI, and other 
flags. 


Async Response Message: 
* None 

Pre Conditions: 
* None. 

Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.55 "TelTapiSimGetIccIdInfo 


Functions 


e TapiResult t TelTapiSimGetIccIdInfo (TelSimIccIdInfo t «pIccIdInfo) 
This function gets ICC id information. 


5.55.1 Function Documentation 
5.55.1.1  TapiResult t TelTapiSimGetIccIdInfo (TelSimIccIdInfo t х pIccIdInfo) 
This function gets ICC id information. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— рІссІаІпјо This parameter returns the ICC id information like icc length and unique card identifi- 
cation number. 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.56 TelTapiSimGetPINStatus 


Functions 


• TapiResult t TelTapiSimGetPINStatus (TelSimPinStatus t «pPinStatus, TelSimPinType t жрРіп- 
Type) 
This function gets the current PIN (PIN1 or UPIN) status. 


5.56.1 Function Documentation 


5.56.1.1  TapiResult t TelTapiSimGetPINStatus (TelSimPinStatus t х pPinStatus, 
TelSimPinType t x pPinType) 


This function gets the current PIN (PIN1 or UPIN) status. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pPinStatus This parameter returns the current Pin status. 
— pPinType This parameter returns the current Pin (Pinl or upin) type. 
Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.57 "TelTapiSimGetPIN2Status 


Functions 


* TapiResult t TelTapiSimGetPIN2Status (TelSimPinStatus t *pPin2Status) 


This function gets the current Pin2 status. 


5.57.1 Function Documentation 
5.57.1.4 TapiResult t TelTapiSimGetPIN2Status (TelSimPinStatus t х pPin2Status) 
This function gets the current Pin2 status. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pPin2Status This parameter returns the current Pin2 status. 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.58 TelTapiSimGetFDNStatus 


Functions 


e TapiResult t TelTapiSimGetFDNStatus (BOOL *pFdnStatus) 


This function is a synchronous API gets the current FDN status. 


5.58.1 Function Documentation 
5.58.1.1 TapiResult t TelTapiSimGetFDNStatus (BOOL х pFdnStatus) 
This function is a synchronous API gets the current FDN status. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pFdnStatus This parameter returns the current fdn status whether enabled or disabled. 


Async Response Message: 


* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.59 TelTapiSimGetSstInfo 


Functions 


e TapiResult t TelTapiSimGetSstInfo (TelSimSstInfo t *pSimSstInfo) 


This function gets the SIM service table information. 


5.59.1 Function Documentation 
5.59.1.1  TapiResult t TelTapiSimGetSstInfo (TelSimSstInfo t x pSimSstInfo) 
This function gets the SIM service table information. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pSimSstInfo This parameter returns the SIM service table information like sst length, sst data etc. 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.60 TelTapiSimGetUstInfo 


Functions 


e TapiResult t TelTapiSimGetUstInfo (TelSimUstInfo_t xpSimUstInfo) 


This function gets the USIM service table information. 


5.60.1 Function Documentation 
5.60.1.1 TapiResult t TelTapiSimGetUstInfo (TelSimUstInfo t x pSimUstInfo) 
This function gets the USIM service table information. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pSimUstInfo This parameter returns the USIM service table information like sst length, sst data 
etc. 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.61 TelTapiSimGetImsilnfo 


Functions 


e TapiResult t TelTapiSimGetImsiInfo (TelSimImsiInfo t xpSimImsiInfo) 


This function is a synchronous API gets the IMSI information. 


5.61.1 Function Documentation 
5.61.1.4  TapiResult t TelTapiSimGetImsilInfo (TelSimImsiInfo t + pSimImsiInfo) 
This function is a synchronous API gets the IMSI information. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pSimImsiInfo This parameter returns the IMSI information. 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.62  TelTapiSimGetEccInfo 


Functions 


• TapiResult t TelTapiSimGetEccInfo (TelSimEccInfo_t «pSimEccInfo, int «pCount) 
This function is a synchronous API used to get ECC data. 


5.62.1 Function Documentation 
5.62.1.1  TapiResult t TelTapiSimGetEccInfo (TelSimEccInfo t x pSimEccInfo, int x pCount) 
This function is a synchronous API used to get ECC data. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 


* None 
Warning: 
* None. 


Parameters: 


— pSimEccInfo This parameter returns the SIM emergency call code information like ecc length, 
service type etc. 


— pCount Specifies number of ECC records. 
Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.63 TelTapiSimGetLanguagePrefInfo 


Functions 


e TapiResult t TelTapiSimGetLanguagePrefInfo (TelSimLanguagelInfo t *pSimLpInfo) 


This API is used to get the language preference information. 


5.63.1 Function Documentation 
5.63.1111  TapiResult t TelTapiSimGetLanguagePrefInfo (TelSimLanguagelInfo t х pSimLpInfo) 
This API is used to get the language preference information. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pSimLpInfo This parameter returns the language preference information. 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.64 TelTapiSimGetLanguagelIndInfo 


Functions 


e TapiResult t TelTapiSimGetLanguagelIndInfo (TelSimLanguageInfo t *«pSimLiInfo) 


This API is used to get the language indication information. 


5.64.1 Function Documentation 
5.64.1.1  TapiResult t TelTapiSimGetLanguageIndInfo (TelSimLanguageInfo t x pSimLilInfo) 
This API is used to get the language indication information. 


Sync (or) Async: 


This is a synchronous function. 


Important Notes: 
* None 
Warning: 
* None. 


Parameters: 


— pSimLilnfo This parameter returns the language indication information. 


Async Response Message: 


* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.65 TelTapiSimGetCardType 


Functions 


e TapiResult t TelTapiSimGetCardType (TelSimCardType t *pCardInfo) 
This function is a synchronous API which gets the Card Type whether SIM Card is a GSM SIM or a 3G SIM. 


5.65.1 Function Documentation 
5.65.1.1 TapiResult t TelTapiSimGetCardType (TelSimCardType t х pCardInfo) 


This function is a synchronous API which gets the Card Type whether SIM Card is a GSM SIM or a 3G 
SIM. 


Sync (or) Async: 
This is a synchronous function. 
Important Notes: 
* None 
Warning: 
* None. 
Parameters: 
— pCardInfo This parameter returns the SIM card type information like whether it is GSM SIM card 
or USIM or it is of unknown type. 
* TAPI SIM CARD TYPE UNKNOWN 
* TAPI SIM CARD TYPE GSM 
* TAPI SIM CARD TYPE USIM 


Async Response Message: 
* None 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


118 Module Documentation 


5.66 TelTapiSimPBGetStorageCount 


Functions 


е TapiResult t TelTapiSimPBGetStorageCount (TelSimPbFileType t StorageFileType, int «pRequest- 
Id) 


This API is used to get number of used records and total records in SIM phone book files. This API is 
applicable only to GSM phonebook (ADN and EXTI), FDN, SDN, LND and MSISDN. 


5.66.1 Function Documentation 


5.66.1.1 ТаріКевші t TelTapiSimPBGetStorageCount (TelSimPbFileType t StorageFileType, int ж 
pRequestlId) 


This API is used to get number of used records and total records in SIM phone book files. This API is 
applicable only to GSM phonebook (ADN and EXT1), FDN, SDN, LND and MSISDN. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* This API is applicable only for 2G phonebook. 


Warning: 


* None. 


Parameters: 
— StorageFileType -Different storage types to be selected in SIM. 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT. SIM PB STORAGE COUNT СМЕ and the event data is Tel- 
SimPbStorageInfo t. Asynchronous return status is indicated by TelSimPbAccessResult t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.67 TelTapiSimPBGetEntryInfo 


Functions 


• TapiResult t TelTapiSimPBGetEntryInfo (TelSimPbFileType t StorageFileType, int »pRequestId) 
This API is used to get max text length and max number length supported by SIM phone book elementary 


file. 


5.67.1 Function Documentation 


5.67.11 TapiResult_t TelTapiSimPBGetEntryInfo (TelSimPbFileType t Storage FileType, int ж 
pRequestlId) 


This API is used to get max text length and max number length supported by SIM phone book elementary 
file. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* The max number length includes the storage space provided by the corresponding EXT file for a 
given Dialling Number file. 


* This API is applicable only for 2G phonebook. 


Warning: 


* None. 


Parameters: 
— StorageFileType -Different storage types to be selected in SIM. 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is TAPI EVENT SIM PB ENTRY INFO CNF and the event data is TelSim- 
PbEntryInfo t. Asynchronous return status is indicated by TelSimPbAccessResult t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.68 TelTapiSimPBReadRecord 


Functions 


* TapiResult t TelTapiSimPBReadRecord (TelSimPbFileType t StorageFileType, unsigned short In- 
dex, int *pRequestId) 


This API is used to read SIM phone book entry information from given storage type. 


5.68.1 Function Documentation 


5.68.1.1 ТаріКевші t TelTapiSimPBReadRecord (TelSimPbFileType t StorageFileType, unsigned 
short Index, int ж pRequestId) 


This API is used to read SIM phone book entry information from given storage type. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* The index ranges from 1 through to a maximum of 254 for a Linear fixed file and 255 for a cyclic 
file. 


* This API is applicable only for 2G phonebook. 


Warning: 


* None. 


Parameters: 
— StorageFileType -Different storage types to be selected in SIM. 
— Index -Index for accessing the SIM data. 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT. SIM PB. ACCESS READ CNEF and the event data is TelSim- 
PbReadResp t. Asynchronous return status is indicated by TelSimPbAccessResult t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.69 TelTapiSimPBUpdateRecord 


Functions 


e TapiResult t TelTapiSimPBUpdateRecord (const TelSimPbRecordData t *pPbRecordData, int *р- 
RequestId) 


This API is used to add or edit SIM phone book record entry information. 


5.69.1 Function Documentation 


5.69.1.1 ТаріКеѕиі t TelTapiSimPBUpdateRecord (const TelSimPbRecordData (ж 
pPbRecordData, int * pRequestId) 


This API is used to add or edit SIM phone book record entry information. 
Sync (or) Async: 
This is an Asynchronous API. 
Important Notes: 
* This API is applicable only for 2G phonebook. 
Warning: 
* None. 


Parameters: 


— pPbRecordData -Different storage types to be selected in SIM. 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT SIM PB UPDATE СМЕ and the event data is TelSimPb- 
ОрааѓеКеѕр t. Asynchronous return status is indicated by TelSimPbAccessResult t. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 


* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.70 TelTapiSimPBDeleteRecord 


Functions 


* TapiResult t TelTapiSimPBDeleteRecord (TelSimPbFileType t StorageFileType, unsigned short 
RecordIndex, int *pRequestId) 


This API is used to delete a SIM phone book record. 


5.70.1 Function Documentation 


5.70.1.1 TapiResult_t TelTapiSimPBDeleteRecord (TelSimPbFileType t StorageFileType, unsigned 
short RecordIndex, int x pRequestId) 


This API is used to delete a SIM phone book record. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* The index ranges from 1 through to a maximum of 254 for a Linear fixed file and 255 for a cyclic 
file. This API is applicable only for 2G phonebook. 


Warning: 


* None. 


Parameters: 
— StorageFileType -Different storage types to be selected in SIM. 
— RecordIndex -Index of the record to be deleted. 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is TAPI EVENT SIM PB DELETE CNF and the event data is TelSimPb- 
ОрааѓеКеѕр t. Asynchronous return status is indicated by TelSimPbAccessResult t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Otherwise it provides an error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.71 SupplementaryServices 


Files 


* file ITapiSs.h 


This file serves as a "C" header file defines functions for Tapi Supplementary Services. 
It contains a sample set of function prototypes that would be required by applications. 


Modules 


TelTapiSsSetCallBarring 
TelTapiSsGetCallBarringStatus 
TelTapiSsChangeBarPassword 
TelTapiSsSetCallForward 

Tel TapiSsGetCallForwardStatus 
TelTapiSsSetCall Waiting 
TelTapiSsGetCall WaitingStatus 
TelTapiSs VerifyBarPwdResponse 
TelTapiSsSetRestrictCallId 
TelTapiSsGetRestrictCallId 
TelTapiSsQueryCapabilityInfo 
Tel TapiUssdSendRequest 

Tel TapiUssdSendUserResponse 
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5.72 "TelTapiSsSetCallBarring 


Functions 


е TapiResult t TelTapiSsSetCallBarring (const TelSsCallBarringInfo t «pBarringInfo, int «pRequest- 
Id) 


This function sends a request to activates/deactivates call barring. This service makes it possible for a 
mobile subscriber to activate barring of certain categories of outgoing or incoming calls according to a 
barring program which is selected from a set of one or more barring programs chosen at provision time and 
is valid for all outgoing or incoming calls, or just those associated with a specific basic service group. Also 
this API allows deactivating call barring based on categories set. 


5.72.1 Function Documentation 


5.72.11 TapiResult t TelTapiSsSetCallBarring (const TelSsCallBarringInfo (ж pBarringInfo, int 
x pRequestld) 


This function sends a request to activates/deactivates call barring. This service makes it possible for a 
mobile subscriber to activate barring of certain categories of outgoing or incoming calls according to a 
barring program which is selected from a set of one or more barring programs chosen at provision time and 
is valid for all outgoing or incoming calls, or just those associated with a specific basic service group. Also 
this API allows deactivating call barring based on categories set. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
< pBarringInfo | * Contains the information about call barring 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


An asynchronous notification event is returned as a confirmation The event associated is TAPI - 
EVENT SS BARRING CNF and asynchronous return status is indicated by TelSsCause t. The event 
data is TelSsInfo t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


130 Module Documentation 


5.73 "TelTapiSsGetCallBarringStatus 


Functions 


* TapiResult t TelTapiSsGetCallBarringStatus (TelSsCallBarType t BarType, TelSsCallType t Call- 
Type, int «pRequestId) 


This function gets call bar status. The mobile subscriber may determine by subscription of a set of one or 
more unique barring programs what kind of outgoing or incoming calls should be barred. 


5.731 Function Documentation 


5.73.11  TapiResult t TelTapiSsGetCallBarringStatus (TelSsCallBarType t BarType, 
TelSsCallType t CallType, int x pRequestId) 


This function gets call bar status. The mobile subscriber may determine by subscription of a set of one or 
more unique barring programs what kind of outgoing or incoming calls should be barred. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 
< BarType % Specifies barring type i.e. Outgoing international, outgoing all, Incoming all etc. 
< CallType | * Specifies the type of call i.e. Voice call, Video Call etc. 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT SS BARRING. QUERYSTATUS CNF and asynchronous re- 
turn status is indicated by TelSsCause_t. The event data is TelSsInfo t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.74 TelTapiSsChangeBarPassword 


Functions 


e TapiResult t TelTapiSsChangeBarPassword (const char *pOldPassword, const char *pNew- 
Password, int *pRequestId) 


This function allows changing of the barring password in Network. 


5.74.1 Function Documentation 


5.74.11 TapiResult t TelTapiSsChangeBarPassword (const char х pOldPassword, const char ж 
pNewPassword, int ж pRequestlId) 


This function allows changing of the barring password in Network. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* Based on 3GPP TS 22.030 section 6.5.4 Registration of New Password. Only one Change Barring 
Password request is allowed at a time and TS might return ТАРІ АРІ REQUEST MAX IN - 
PROGRESS if another request is received. 


Warning: 


* None. 


Parameters: 
< pOldPassword — * Old password set for Barring in Network. This is Null terminated string 
< pNewPassword • New password for Barring to be set in Network. This is Null terminated string. 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT 55 BARRING. CHANGEPASS СМЕ and asynchronous re- 
turn status is indicated by TelSsCause t. There is no event data with this event. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.75 


TelTapiSsSetCallForward 


Functions 


е TapiResult t TelTapiSsSetCallForward (const TelSsForwardInfo t *pForwardInfo, int «pRequest- 
Id) 


5.75.1 


This function allows to set (register/erase/activate/deactivate) call forwarding option at the Network. This 
enables to forward the calls to another party. This service permits a called mobile subscriber to have the 
network send all incoming calls, or just those associated with a specific Basic service group, addressed 
to the called mobile subscriber's directory number and which meet various call FORWARD condition to 
another directory number. The ability of the served mobile subscriber to originate calls is unaffected. If the 
service is activated, a call is forwarded only if under this call forward condition. Application has to call 
this API in order to explicitly register/erase/activate/deactivate the call forwarding. Request will be passed 
irrespective of whether already another SS call forward is ongoing. 


Function Documentation 


5.75.1.4 TapiResult t TelTapiSsSetCallForward (const TelSsForwardInfo t x pForwardInfo, int ж 


pRequestlId) 


This function allows to set (register/erase/activate/deactivate) call forwarding option at the Network. This 


enables 


to forward the calls to another party. This service permits a called mobile subscriber to have the 


network send all incoming calls, or just those associated with a specific Basic service group, addressed 
to the called mobile subscriber's directory number and which meet various call FORWARD condition to 
another directory number. The ability of the served mobile subscriber to originate calls is unaffected. If 
the service is activated, a call is forwarded only if under this call forward condition. Application has to call 
this API in order to explicitly register/erase/activate/deactivate the call forwarding. Request will be passed 
irrespective of whether already another SS call forward is ongoing. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


< pForwardInfo • Contains the Call forward information like forward mode, forward type, etc. 


— pRequestId • Unique identifier for a particular request. 


* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT 55 FORWARD СМЕ and asynchronous return status is indi- 
cated by TelSsCause t. The event data will be TelSsInfo t. 
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Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 


( ToNumber) 


ТАР] ЕУЕНТ 55 FORWARD CNF 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


136 Module Documentation 


5.76 TelTapiSsGetCallForwardStatus 


Functions 


e TapiResult t TelTapiSsGetCallForwardStatus (TelSsForwardType t Type, TelSsForwardWhen - 
t Condition, int *pRequestlId) 


This function provides option to get the call forwarding status of different calls from Network. 


5.76.1 Function Documentation 


5.76.1.1  TapiResult t TelTapiSsGetCallForwardStatus (TelSsForwardType t Туре, 
TelSsForwardWhen t Condition, int х pRequestId) 


This function provides option to get the call forwarding status of different calls from Network. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 
— Туре * Specifying the Forward call type i.e. voice call, Video Call, Data Calls etc. 


< Condition • Used to specify the forward condition i.e. unconditional, When no reply, when 
busy, when not reachable etc. 


— pRequestId  * Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated 15 ТАРІ EVENT. SS FORWARD QUERYSTATUS СМЕ and asynchronous re- 
turn status is indicated by TelSsCause t. The event data is TelSsInfo t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.77 "TelTapiSsSetCallWaiting 


Functions 


e TapiResult t TelTapiSsSetCall Waiting (BOOL bCwStatus, int »pRequestld) 


This function activates/deactivates the call waiting service. The call waiting service permits a mobile to 
be notified of an incoming call (as per basic call procedures) whilst the traffic channel (BM or LM) is not 
available for the incoming call and the mobile subscriber is engaged in an active or held call. Subsequently, 
the subscriber can accept, reject, or ignore the incoming call. 


5.77.1 Function Documentation 
5.77.11 TapiResult t TelTapiSsSetCall Waiting (BOOL bCwStatus, int * pRequestlId) 


This function activates/deactivates the call waiting service. The call waiting service permits a mobile to 
be notified of an incoming call (as per basic call procedures) whilst the traffic channel (BM or LM) is not 
available for the incoming call and the mobile subscriber is engaged in an active or held call. Subsequently, 
the subscriber can accept, reject, or ignore the incoming call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


< bCwStatus • Specifies the status of call-waiting service i.e. On (TRUE) or off (FALSE) 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT. 55 WAITING. СМЕ and asynchronous return status is indi- 
cated by TelSsCause_t. The event data is TelSsInfo t. 

Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.78 TelTapiSsGetCallWaitingStatus 


Functions 


• TapiResult t TelTapiSsGetCallWaitingStatus (int *pRequestId) 


This function queries the status of call waiting service. The call waiting service permits a mobile to be 
notified of an incoming call (as per basic call procedures) whilst the traffic channel (BM or LM) is not 
available for the incoming call and the mobile subscriber is engaged in an active or held call. Subsequently, 
the subscriber can accept, reject, or ignore the incoming call. 


5.78.1 Function Documentation 
5.78.1.1 TapiResult t TelTapiSsGetCallWaitingStatus (int « pRequestId) 


This function queries the status of call waiting service. The call waiting service permits a mobile to be 
notified of an incoming call (as per basic call procedures) whilst the traffic channel (BM or LM) is not 
available for the incoming call and the mobile subscriber is engaged in an active or held call. Subsequently, 
the subscriber can accept, reject, or ignore the incoming call. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from О to 255 if the API is returned successfully 
• -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
The event associated is ТАРІ EVENT. SS WAITING. QUERYSTATUS СМЕ and asynchronous re- 
turn status is indicated by TelSsCause_t. The event data is TelSsInfo t. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.79 TelTapiSsVerifyBarPwdResponse 


Functions 


e TapiResult t TelTapiSsVerifyBarPwdResponse (int «pRequestId, const char *pBarPwdInfo) 


This API allows Application to provide barring password requested by network for Call Barring Request or 
Change barring password request. 


5.79.1 Function Documentation 


5.79.1.1  TapiResult t TelTapiSsVerifyBarPwdResponse (int х pRequestId, const char ж 
pBarPwdlnfo) 


This API allows Application to provide barring password requested by network for Call Barring Request 
or Change barring password request. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 


< pBarPwdlnfo | * Barring password is 4 digit interger. (Character array of password digits and 
not a Null terminated string). 


— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 
This Asynchronous event TAPI EVENT SS VERIFY PWD CNF is returned in response and asyn- 
chronous return status is indicated by TelSsCause_t. There is no event data associated with this event. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.80 TelTapiSsSetRestrictCallId 


Functions 


* TapiResult t TelTapiSsSetRestrictCallId (TelSsRestrictIDStatus_t Status) 


This function sets the status of restrict call ID. After set, the phone will show/hide the caller number to the 
called party for all subsequent calls, regardless of type of call. This API assumes user service subscription 
allows changing this setting, sometimes referred to as 'temporary mode’. If the presentation mode is not 
temporary, the caller of this API will receive an error result. 


5.80.1 Function Documentation 
5.80.1.1  TapiResult t TelTapiSsSetRestrictCallId (TelSsRestrictIDStatus t Status) 


This function sets the status of restrict call ID. After set, the phone will show/hide the caller number to the 
called party for all subsequent calls, regardless of type of call. This API assumes user service subscription 
allows changing this setting, sometimes referred to as 'temporary mode'. If the presentation mode is not 
temporary, the caller of this API will receive an error result. 


Sync (or) Async: 
This is a Synchronous API. 
Important Notes: 
* None 
Warning: 
* None. 
Parameters: 
< Status • Specifies whether to restrict call id or not i.e On or Off. 
Async Response Message: 
* None. 


Pre Conditions: 
* None. 

Post Conditions: 
* None. 

Returns: 


Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.81 TelTapiSsGetRestrictCallld 


Functions 


e TapiResult t TelTapiSsGetRestrictCallld (TelSsRestrictIDStatus t *pStatus) 


This function gets the status of call ID restriction for all subsequent calls. 


5.81.1 Function Documentation 
5.81.1.1 TapiResult t TelTapiSsGetRestrictCallId (TelSsRestrictIDStatus t х pStatus) 
This function gets the status of call ID restriction for all subsequent calls. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 


— pStatus • Specifies whether to restrict call id or not i.e On or Off. 


Async Response Message: 
None. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.82 TelTapiSsQueryCapabilityInfo 


Functions 


е TapiResult t TelTapiSsQueryCapabilityInfo (int »pRequestId) 
This API allows Application to query what all SS services are supported at OEM. 


5.82.1 Function Documentation 
5.82.1.4  TapiResult t TelTapiSsQueryCapabilityInfo (int x pRequestId) 
This API allows Application to query what all SS services are supported at OEM. 


Sync (or) Async: 
This is an Asynchronous API. 


Important Notes: 
* Note: 
Warning: 
* None. 


Parameters: 
— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -І (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


This Asynchronous event TAPI EVENT. 55 QUERYCAPABILITY INFO CNF is returned in re- 
sponse and asynchronous return status is indicated by TelSsCause t. The event data is TelSsCapability- 
Info t. 


Pre Conditions: 


* None. 


Post Conditions: 
* None. 
Returns: 


Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.83 TelTapiUssdSendRequest 147 


5.83 TelTapiUssdSendRequest 


Functions 


e TapiResult t TelTapiUssdSendRequest (const TelSsUssdMsglInfo t *pAppMsg, int »pRequestlId) 


This function is used to send USSD to the Network. The response to the request is a displayable string which 
will be returned to the Application via LiMo EventDelivery. 


5.83. Function Documentation 


5.83.1.1  TapiResult t TelTapiUssdSendRequest (const TelSsUssdMsgInfo t x pAppMsg, int * 
pRequestlId) 


This function is used to send USSD to the Network. The response to the request is a displayable string 
which will be returned to the Application via LiMo EventDelivery. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 
Warning: 
* None. 


Parameters: 
< pAppMsg • Data coding scheme used (GSM 7Ы or 8bit default alphabet etc, defined as 3GPP 
TS 23.038) 

* USSD String data length 
* ANSI string passed by the client 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT 55 USSD CNF and asynchronous return status is indicated 
by TelSsCause t. The event data is TelSsUssdMsglInfo t. 


Pre Conditions: 
* No SS and USSD Transaction should be ongoing. If there an ongoing transaction, new USSD 
request will be returned to the Application with an error (USSD BUSY) 
Post Conditions: 


* None. 


Returns: 


Return Type (TapiResult t) 
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е TAPI АРІ SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 


Forward USSD msg 
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5.84 TelTapiUssdSendUserResponse 


Functions 


е TapiResult t TelTapiUssdSendUserResponse (const TelSsUssdMsgInfo t *pAppMsg, int p- 
RequestId) 


This function is called to send a USSD response provided by the User to the Network for the USSD indication 
received. This contains USSD response type, USSD Indication type and USSD Response data. 


5.841 Function Documentation 


5.84.1.1 ТаріКеѕи є TelTapiUssdSendUserResponse (const TelSsUssdMsgInfo_t x pAppMsg, int ж 
pRequestlId) 


This function is called to send a USSD response provided by the User to the Network for the USSD 
indication received. This contains USSD response type, USSD Indication type and USSD Response data. 
Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 


* None. 


Warning: 


* None. 


Parameters: 
< pAppMsg • Data coding scheme used (GSM 7bit or 8bit default alphabet etc, defined as 3GPP 
TS 23.038) 

* USSD String data length 
* ANSI string passed by the client 

— pRequestId • Unique identifier for a particular request. 
* request id value can be any value from 0 to 255 if the API is returned successfully. 
* -| (INVALID REQUEST ID) will be sent in case of failure. 


Async Response Message: 


The event associated is ТАРІ EVENT 55 USSD IND КР and asynchronous return status is indi- 
cated by TelSsCause t. The event data is TelSsUssdMsgInfo_t. 


Pre Conditions: 


* No SS and USSD Transaction should be ongoing. If there an ongoing transaction, new USSD 
request will be returned to the Application with an error (USSD BUSY) 


Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Refer TapiResult t for failure and error code 


Prospective Clients: 


External Apps. 
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5.85 Common 


Files 


* file TapiCommon.h 


This file serves as a "C" header file defines functions for Tapi Common Interfaces like Callback Registration 
/ De-registration. 
It contains a sample set of function prototypes that would be required by applications. 


Modules 


* TelTapiRegisterClass 
* TelTapiRegisterEvent 
* TelTapiDeRegister 

* TelTapiTunnelReq 

* TelTapiGetVersionInfo 


Data Structures 


* struct TelTapiEvent t 


Typedefs 


e typedef bool(*) TelAppCallback (const TelTapiEvent t *pTapiEvent) 


Enumerations 


* enum TelTapiEventClass t { 


TAPI EVENT NONE = -1, TAPI EVENT CLASS CALL VOICE = 0x00, TAPI EVENT - 
CLASS CALL DATA, TAPI EVENT CLASS NETTEXT, 


TAPI EVENT CLASS NETWORK, TAPI EVENT CLASS SS, TAPI EVENT CLASS SIM, 
TAPI EVENT CLASS ERR, 

TAPI EVENT CLASS UTIL, TAPI EVENT CLASS ALL } 

enum TelTapiEventType t { 


TAPI EVENT CALL SETUP CNF - 1, TAPI EVENT CALL ALERT IND, TAPI EVENT - 
CALL CONNECTING IND, TAPI EVENT CALL CONNECTED IND, 


TAPI EVENT CALL INCOM IND, TAPI EVENT CALL ANSWER CNF, TAPI EVENT - 
CALL RETRIEVE CNF, TAPI EVENT CALL RETRIEVE IND, 


ТАРІ EVENT CALL HOLD IND, ТАРІ EVENT CALL HOLD CNF, ТАРІ EVENT - 
CALL TRANSFER CNF, TAPI EVENT CALL TRANSFER IND, 


TAPI EVENT CALL SETUPCONFERENCE CNF, TAPI EVENT CALL - 
SETUPCONFERENCE IND, ТАРІ EVENT CALL SPLITCONFERENCE СМЕ, ТАРІ - 
EVENT CALL SEND DTMF СМЕ, 


ТАРІ EVENT САШ, WAITING IND, TAPI EVENT CALL FORWARD IND, TAPI - 
EVENT CALL USERINFO IND, TAPI EVENT CALL RELEASE CNF, 
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TAPI EVENT CALL RELEASE ALL CNF, TAPI EVENT CALL END IND, TAPI - 
EVENT NETTEXT READ SMS CNF, TAPI EVENT NETTEXT GET COUNT CNF, 


TAPI EVENT NETTEXT SENTSTATUS СМЕ,  TAPI EVENT МЕТТЕХТ СЕТ PARAM - 
CNF, TAPI EVENT NETTEXT DELETE STATUS CNF, TAPI EVENT NETTEXT SAVE - 
STATUS CNF, 


TAPI EVENT NETTEXT SET REQUEST CNF, TAPI EVENT NETTEXT GET CB - 
CONFIG_CNF, TAPI EVENT NETTEXT GET SMSBEARER CNF, TAPI EVENT - 
NETTEXT DELIVERY REPORT CNF, 


TAPI EVENT NETTEXT INCOM IND, TAPI EVENT NETTEXT CB INCOM IND, TAPI - 
EVENT NETTEXT MEMORY STATUS IND, ТАРІ EVENT NETWORK. SELECT СМЕ, 


ТАРІ EVENT NETWORK SEARCH СМЕ, TAPI EVENT NETWORK - 
GETSELECTIONMODE CNF, ТАРІ EVENT NETWORK GETNETWORKINFO CNF, 
TAPI EVENT NETWORK CANCELMANUALSEARCH. CNF, 


TAPI EVENT NETWORK. CANCELMANUALSELECTION CNF, TAPI EVENT - 
NETWORK SETNWORDER СМЕ, ТАРІ EVENT NETWORK SETNWMODE СМЕ, ТАРІ - 
EVENT NETWORK SETSELECTIONMODE CNF, 


ТАРІ EVENT NETWORK SETNWBAND СМЕ, TAPI EVENT NETWORK - 
SETSERVICEDOMAIN CNF, TAPI EVENT NETWORK CONFIG CNF, TAPI EVENT - 
NETWORK CHANGE IND, 


ТАРІ EVENT NETWORK SEARCH IND, ТАРІ EVENT NETWORK RADIO INFO IND, 
TAPI EVENT SS BARRING CNF, TAPI EVENT SS BARRING CHANGEPASS CNF, 


TAPI EVENT SS BARRING QUERYSTATUS CNF, TAPI EVENT SS FORWARD CNF, 
TAPI EVENT 55 FORWARD QUERYSTATUS CNF, TAPI EVENT SS WAITING CNF, 


TAPI EVENT SS WAITING QUERYSTATUS CNF, TAPI EVENT SS USSD CNF, TAPI - 
EVENT SS USSDCNF RSP, TAPI EVENT SS USSDCNF NOTIFY, 


TAPI EVENT SS USSD IND RSP, TAPI EVENT SS VERIFY PWD CNF, TAPI EVENT - 
SS QUERYCAPABILITY INFO CNF, TAPI EVENT SS USSD IND, 


TAPI EVENT SS USSD IND NOTIFY, TAPI EVENT SS GET PASSWORD IND, TAPI - 
EVENT SIM FILE INFO СМЕ, ТАРІ EVENT SIM READ FILE СМЕ, 


ТАРІ EVENT SIM UPDATE FILE СМЕ, ТАРІ EVENT SIM VERIFY PIN СМЕ, ТАРІ - 
EVENT SIM CHANGE PIN CNF, TAPI EVENT SIM DISABLE PIN CNF, 


TAPI EVENT SIM ENABLE PIN CNF, TAPI EVENT SIM UNBLOCK PIN CNF, TAPI - 
EVENT SIM DISABLE FDN CNF, TAPI EVENT SIM ENABLE FDN CNF, 


TAPI EVENT SIM PB STORAGE COUNT CNF, TAPI EVENT SIM PB ENTRY INFO - 
CNF, TAPI EVENT SIM PB ACCESS READ CNF, TAPI EVENT SIM PB UPDATE CNF, 


TAPI EVENT SIM PB DELETE CNF, TAPI EVENT SIM STATUS IND, TAPI EVENT - 
SIM. FDN STATUS IND, ТАРІ EVENT ERR. RESERVEDI IND, 


ТАРІ EVENT ERR RESERVED2 IND, ТАРІ EVENT ERR RESERVED3 IND, ТАРІ - 
EVENT ERR RESERVEDA IND, ТАРІ EVENT ERR RESERVEDS5 IND, 


TAPI EVENT TUNNEL INFO CNF, TAPI EVENT TUNNEL INFO IND } 


5.85.1 Typedef Documentation 


5.85.1.1 typedef bool(«) TelAppCallback(const TelTapiEvent t «pTapiEvent) 


This describes the application callback function which will get invoked to notify the client application 
about the Telephony events based on TAPI asynchronous responses / indications. 
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LIMO 
APPLICATION ТАР! Library ED / IPC 


TelAsyncRespCaliBack 


1. verifies any request is present based on request id 


2. Handles the asynchronous response/Indications 
3. Invokes the callback registered accordingly 


Tel&ppCallback 


API Return 


5.85.2 Enumeration Type Documentation 
5.85.2.1 enum TelTapiEventClass t 


This enumeration defines the Telephony Event Class. Class is nothing but a group of events related to a par- 
ticular subsystem. Example of one Event Class is ТАРІ CALL. VOICE. This becomes the first parameter 
of telephony notifications. 


Enumerator: 


TAPI EVENT CLASS CALL VOICE Voice Call Event Class 
ТАРІ EVENT. CLASS CALL DATA Data Call Event Class 
TAPI EVENT CLASS NETTEXT Nettext (SMS/CB) Event Class 
TAPI EVENT CLASS NETWORK Network Event Class 

TAPI EVENT CLASS SS SS Event Class 

TAPI EVENT CLASS SIM SIM Event Class 

TAPI EVENT CLASS ERR Fatal error Event Class 

TAPI EVENT CLASS UTIL Utility Events Class 

TAPI EVENT CLASS ALL АП Events Class 


5.85.2.2 enum TelTapiEventType t 


This enumeration defines the event types. Each event type will be mapped to one telephony Notification 
Id. For Example: TAPI EVENT CALL INCOM IND is mapped to Telephony.Call.Voice.Incoming. 


Enumerator: 


TAPI EVENT CALL SETUP CNF This event indicates the Call Setup request triggered 

TAPI EVENT CALL ALERT IND This event indicates the Call is in Alerting stage 

TAPI EVENT CALL CONNECTING IND This event indicates the Call is in Connecting stage 
TAPI EVENT CALL CONNECTED IND This event indicates the Call is Connected 
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TAPI EVENT CALL INCOM IND This event indicates Incoming Call indication to Application 

TAPI EVENT CALL ANSWER CNF Incoming call was answered 

TAPI EVENT CALL RETRIEVE CNF This event indicates Call is retrieved from held state 

TAPI EVENT CALL RETRIEVE IND This event indicates that other party has retrieved the call 
from hold 

TAPI EVENT CALL HOLD IND This event indicates that other party is has put the call on hold 

ТАРІ EVENT CALL HOLD СМЕ This event indicates is call is put on hold 

TAPI EVENT CALL TRANSFER CNF This event indicates is call is explicitly transferred 

TAPI EVENT CALL TRANSFER IND Call Transfer Indication 

TAPI EVENT CALL SETUPCONFERENCE CNF This event indicates that Call is joined in a 
conference 

TAPI EVENT CALL SETUPCONFERENCE IND Conference setup indication 

TAPI EVENT CALL SPLITCONFERENCE CNF This event indicates Call is split from confer- 
ence 

TAPI EVENT CALL SEND DTMF CNF This event indicates the confirmation for sending 
DTMF Digits to the network 

TAPI EVENT CALL WAITING IND Call waiting indication 

TAPI EVENT CALL FORWARD IND This event indication for Call is forwarded 

TAPI EVENT CALL USERINFO IND This event is indicated when User Information is ex- 
changed during the call 

TAPI EVENT CALL RELEASE CNF This event is indicated when all the calls released re- 
quested by the application 

TAPI EVENT CALL RELEASE ALL СМЕ This event is indicated when all the calls released 
requested by the application 

TAPI EVENT CALL END IND This event indicates the Call is Ended. This event can be so- 
licited/unsolicited. 

TAPI EVENT NETTEXT READ SMS CNF This event is returned in response to SMS Read 
message 

TAPI EVENT NETTEXT GET COUNT CNF This event is returned in response to Get Number 
of messages stored in SIM 

ТАРІ EVENT NETTEXT SENTSTATUS СМЕ This event is returned in response to SMS mes- 
sage sent 

ТАРІ EVENT NETTEXT GET PARAM СМЕ This event is returned in response to NetText Get 
parameters 

TAPI EVENT NETTEXT DELETE STATUS CNF This confirmation event is a returned indi- 
cating the delete message e status 

TAPI EVENT NETTEXT SAVE STATUS CNF This confirmation event is a returned indicating 
the Save SMS into SIM status 

TAPI EVENT NETTEXT SET REQUEST CNF This event is returned as a confirmation for 
SET nettext APIs 

ТАРІ EVENT NETTEXT GET CB CONFIG СМЕ This event is returned with Get CB config- 
uration details 

TAPI EVENT NETTEXT GET SMSBEARER CNF This event is returned as a response to get 
preferred bearer used for SMS Transport 


TAPI EVENT NETTEXT DELIVERY REPORT CNF This event is returned in response to 
send delivery report 
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TAPI EVENT NETTEXT INCOM IND This is an unsolicited Incoming SMS Event 

TAPI EVENT NETTEXT CB INCOM IND This is an unsolicited Incoming cell broadcast mes- 
sage 

ТАРІ EVENT NETTEXT MEMORY STATUS IND This event is an unsolicited event indicating 
SIM memory status 


TAPI EVENT NETWORK SELECT CNF This confirmation event is returned when user manu- 
ally selected a network from list for Network selection 


TAPI EVENT NETWORK SEARCH CNF This event is returned as confirmation for manual 
Network search with the available network list 


TAPI EVENT NETWORK GETSELECTIONMODE CNF This event is returned when Get se- 
lection mode indication is received at TS 


TAPI EVENT NETWORK GETNETWORKINFO CNF This event is returned when Get net- 
work information is requested 


ТАРІ EVENT NETWORK CANCELMANUALSEARCH СМЕ This event is returned on cancel- 
lation of manual network search 


TAPI EVENT NETWORK CANCELMANUALSELECTION CNF This event is returned on 
cancellation of manual network selection from network list 


TAPI EVENT NETWORK SETNWORDER СМЕ This event is returned on setting network or- 
der 


TAPI EVENT NETWORK SETNWMODE CNF This event is returned on setting network mode 


TAPI EVENT NETWORK SETSELECTIONMODE СМЕ This event is returned on setting net- 
Work selection mode 


TAPI EVENT NETWORK SETNWBAND CNF This event is returned on setting network band 


TAPI EVENT NETWORK SETSERVICEDOMAIN CNF This event is returned on setting net- 
Work service domain 


ТАРІ EVENT NETWORK CONFIG СМЕ This event is returned on setting the network configu- 
ration at OEM 


TAPI EVENT NETWORK CHANGE IND This event is returned when Telephony server re- 
ceives any indication from OEM about change in Network registration/selection/status 


TAPI EVENT NETWORK SEARCH IND This is unsolicited event indicated when TS receives 
any indication of Manual search indication with list 


TAPI EVENT NETWORK RADIO INFO IND This is unsolicited event indicating Radio signal 
indication 

TAPI EVENT SS BARRING CNF This confirmation event is sent when Barring activa- 
tion/deactivation is requested 


ТАРІ EVENT SS BARRING CHANGEPASS СМЕ This event is returned as Barring password 
change confirmation 


TAPI EVENT SS BARRING QUERYSTATUS СМЕ This event is returned as Barring status 
query confirmation 


TAPI EVENT SS FORWARD CNF This event is returned as confirmation for Forward Activa- 
tion/Deactivation/Registration/Erasure 


TAPI EVENT SS FORWARD QUERYSTATUS CNF This event is returned as confirmation for 
Forward Status query confirmation 


TAPI EVENT SS WAITING CNF This event is returned as confirmation for Call waiting activa- 
tion/deactivation 
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TAPI EVENT SS WAITING QUERYSTATUS CNF This event is returned as Call waiting status 
query confirmation 


TAPI EVENT SS USSD CNF This event is returned as USSD send confirmation 


TAPI EVENT SS USSDCNF RSP This event is returned as USSD confirmation response which 
is sent as a response to received USSD 


TAPI EVENT SS USSDCNF NOTIFY This event is an unsolicited USSD notification 
TAPI EVENT SS USSD IND RSP USSD Indication Response 


TAPI EVENT SS VERIFY PWD CNF This event is sent when verify pwd response is sent to 
Network 


TAPI EVENT SS QUERYCAPABILITY INFO CNF Event associated with the interrogation of 
supported supplementary services at OEM. 


TAPI EVENT SS USSD IND This is an unsolicited USSD indication 
TAPI EVENT SS USSD IND NOTIFY This event is an unsolicited USSD notification 


TAPI EVENT SS GET PASSWORD IND This event is indicated to the Application when net- 
work requests for Call barring Get password for barring operation 


TAPI EVENT SIM FILE INFO CNF File info 

TAPI EVENT SIM READ FILE CNF Read file 

TAPI EVENT. SIM UPDATE FILE CNF Updated file 

TAPI EVENT SIM VERIFY PIN CNF Verified Chv 

TAPI EVENT SIM CHANGE PIN CNF Changed Chv 

TAPI EVENT SIM DISABLE PIN CNF Disabled Chv 

TAPI EVENT SIM ENABLE PIN CNF Enabled Chv 

TAPI EVENT SIM UNBLOCK PIN CNF Unblocked Chv 

TAPI EVENT SIM DISABLE FDN CNF Disabled Fdn 

TAPI EVENT SIM ENABLE FDN CNF Enabled Fdn 

TAPI EVENT SIM PB STORAGE COUNT CNF Phonebook storage count 
TAPI EVENT SIM PB ENTRY INFO CNF Phonebook entry information 
TAPI EVENT SIM PB ACCESS READ CNF  Phonebook access read 
TAPI EVENT SIM PB UPDATE CNF Phonebook update result 

TAPI EVENT SIM PB DELETE CNF Phonebook delete result 

TAPI EVENT SIM STATUS IND  Unsolicited event — whenever there is a changes in SIM status 


TAPI EVENT SIM FDN STATUS IND Unsolicited event — whenever there is a changes in 
FDN status 


TAPI EVENT ERR RESERVEDI IND This event is notified to application about some error has 
occurred at OEM and can be used for debugging purpose 


ТАРІ EVENT ERR RESERVED?2 IND This event is notified to application about some error has 
occurred at OEM and can be used for debugging purpose 


ТАРІ EVENT ERR RESERVED3 IND This event is notified to application about some error has 
occurred at OEM and can be used for debugging purpose 


ТАРІ EVENT ERR RESERVED4 IND This event is notified to application about some error has 
occurred at OEM and can be used for debugging purpose 


TAPI EVENT ERR RESERVEDS IND This event is notified to application about some error has 
occurred at OEM and can be used for debugging purpose 


TAPI EVENT TUNNEL INFO CNF This confirmation event is returned for Tunnel information 


TAPI EVENT TUNNEL INFO IND This event is an unsolicited event informing about Tunnel 
information 
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5.86 TelTapiRegisterClass 


Functions 


е TapiResult t TelTapiRegisterClass (TelTapiEventClass t EventClass, unsigned int *pSubscriptionId, 
TelAppCallback AppCb) 


This function is exposed to the TAPI clients to register the callback which needs to be invoked for a particular 
class of Telephony confirmations/indications. If Application tries to call this TelTapiRegisterClass API for 
the same event class multiple times (with same callback or different callback), multiple callback registration 
will happen. SubscriptionID is returned back to the application, if the registration procedure is successful. 
This subscription id needs to be used for de-registering the callback. 


5.86.4] Function Documentation 


5.86.1.1  TapiResult t TelTapiRegisterClass (Tel TapiEventClass t EventClass, unsigned int ж 
pSubscriptionId, TelAppCallback AppCb) 


This function is exposed to the TAPI clients to register the callback which needs to be invoked for a 
particular class of Telephony confirmations/indications. If Application tries to call this TelTapiRegister- 
Class API for the same event class multiple times (with same callback or different callback), multiple 
callback registration will happen. SubscriptionID is returned back to the application, if the registration 
procedure is successful. This subscription id needs to be used for de-registering the callback. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* Incase Application has registered for multiple callbacks for an event class and it wants to have 
only one callback to be registered for that particular event class, then Application needs to explic- 
itly deregister the callbacks based on subscription id. If Application wants to modify the already 
registered event class with a different callback, then it needs to deregister the already registered 
TAPI event class with subscription id received and Application has to register again with a new 
callback for that TAPI event class. 


Warning: 


Parameters: 


< EventClass • EventClass for which the callback registration is required. 
< AppCb  * Callback which will be invoked when an event occurs for that particular event class. 


— pSubscriptionld • An unique identifier identifying the callback registration. 


Async Response Message: 


* None. 


Pre Conditions: 


* None. 
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Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.87 TelTapiRegisterEvent 


Functions 


• TapiResult t TelTapiRegisterEvent (TelTapiEventType t EventType, unsigned int «pSubscriptionld, 
TelAppCallback AppCb) 


This function is used to register the callback function for a specific TAPI Event. If Application tries to 
register a callback for a specific event multiple times, then multiple callbacks will be registered. When an 
event indication is received, then registered callbacks for the specific event will be invoked multiple times. 


5.871 Function Documentation 


5.87.11  TapiResult t TelTapiRegisterEvent (TelTapiEventType t EventType, unsigned int ж 
pSubscriptionId, TelAppCallback AppCb) 


This function is used to register the callback function for a specific TAPI Event. If Application tries to 
register a callback for a specific event multiple times, then multiple callbacks will be registered. When an 
event indication is received, then registered callbacks for the specific event will be invoked multiple times. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* Incase Application has registered for multiple callbacks for a event and it wants to have only one 
callback to be registered for that particular event, then Application needs to explicitly deregister 
the callbacks based on subscription id. If Application wants to modify the already registered 
event with a different callback, then it needs to deregister the already registered TAPI event with 
subscription id received and Application has to register again with a new callback for that TAPI 
event. 


Warning: 


Parameters: 


< EventType • TAPI Event for which the callback registration is required. 
< AppCb ” Callback which will be invoked when an event occurs for that particular event class. 


— pSubscriptionld • An unique identifier identifying the callback registration. 


Async Response Message: 


* None. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 
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Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.88 TelTapiDeRegister 


Functions 


e TapiResult t TelTapiDeRegister (unsigned int SubscriptionId) 


This function will de-register the application callback registered for the specific event or event class based 
on the subscription id. This identifier is the same subscription identifier which is returned back to the 
application during TAPI registration procedure. If de-register API is called during any service requests, 
Application registered callback will be cleared based on the subscription id. No application callback shall 
be invoked in case any confirmations/indications are received from TS. 


5.88.4 Function Documentation 
5.88.1.4  TapiResult t TelTapiDeRegister (unsigned int SubscriptionId) 


This function will de-register the application callback registered for the specific event or event class based 
on the subscription id. This identifier is the same subscription identifier which is returned back to the 
application during TAPI registration procedure. If de-register API is called during any service requests, 
Application registered callback will be cleared based on the subscription id. No application callback shall 
be invoked in case any confirmations/indications are received from TS. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 
* Application has to de-register each registration using subscription id explicitly as there is no 


overriding of callback registration. 


Warning: 


Parameters: 


< Subscriptionld • An unique identifier identifying the callback registration. 


Async Response Message: 


* None. 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
е ТАРІ АРІ SUCCESS - indicating that the operation has completed successfully. 
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* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.89 TelTapiTunnelReq 


Functions 


e TapiResult t TelTapiTunnelReq (const TelTapiTunnelInfo t *pTunnelInfo, int xpRequestId) 
This API allows Application to send any proprietary information to OEM. 


5.891 Function Documentation 


5.89.1.1 TapiResult t TelTapiTunnelReq (const TelTapiTunnelInfo t х pTunnelInfo, int ж 
pRequestlId) 


This API allows Application to send any proprietary information to OEM. 


Sync (or) Async: 


This is an Asynchronous API. 


Important Notes: 
* None. 


Warning: 


Parameters: 


< pTunnellnfo ° This information holds the length of the tunneling data and actual tunneling data. 


— pRequestId • Callback which will be invoked when an event occurs for that particular event 
class. 


Async Response Message: 


* This Asynchronous event ТАРІ EVENT TUNNEL, INFO СМЕ is returned in response and as- 
sociated event data is TelTapiTunnelInfo t with this event. Asynchronous return status will be 
indicated by tunnel, status which is a Boolean indicating success(1-True) or Failure(0-False) 


Pre Conditions: 


* None. 
Post Conditions: 
* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 
* Else it will return failure and error code (Refer TapiResult t) 
Prospective Clients: 


External Apps. 
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5.90 TelTapiGetVersionInfo 


Functions 


e TapiResult t TelTapiGetVersionInfo (const Tel TapiVersionInfo t *pVersionInfo) 


This function returns the version information of Telephony Server. 


5.90.1 Function Documentation 
5.90.1.1 TapiResult t TelTapiGetVersionInfo (const TelTapiVersionInfo t x pVersionInfo) 
This function returns the version information of Telephony Server. 


Sync (or) Async: 


This is a Synchronous API. 


Important Notes: 


* None. 


Warning: 


Parameters: 


— pVersionInfo • Version information will be returned from Telephony Server 


* This structure will hold Major version and Minor version details. For example, if Telephony 
version is 1.10, Major version will hold value 1 and Minor Version will hold value 10. 


Async Response Message: 
* NA 


Pre Conditions: 


* None. 


Post Conditions: 


* None. 


Returns: 
Return Type (TapiResult t) 
* TAPI API SUCCESS - indicating that the operation has completed successfully. 


* Else it will return failure and error code (Refer TapiResult t) 


Prospective Clients: 


External Apps. 
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5.91 Call Data Structures 


Files 


file TelCall.h 


This file serves as a "C" header file defines structures for Tapi Call Services. 


It contains a sample set of constants, enums, structs that would be required by applications. 


Data Structures 


struct TelCallCugInfo t 

struct TelCallingNamelInfo t 
struct TelCallUusInfo t 

struct TelCallSetupParams t 
struct TelCallStatus t 

struct TelCallUserDataInfo t 
struct TelCallEndInfo t 

struct TelCallRedirectionInfo t 
struct TelCallIncomingCallInfo t 


Defines 


#define ТАРІ CALLING NAME SIZE MAX 80 
#define ТАРІ CALL UUS DATA LEN MAX 131 


Enumerations 


enum TelCallCause t ( 


TAPI CAUSE SUCCESS, TAPI CAUSE ACCESSDISCARD, 
BYOPERATOR, TAPI CAUSE BEARERMODE NOTIMPL, 


TAPI CAUSE BARR - 


TAPI CAUSE BEARERMODE RESTRICTED, TAPI CAUSE BEARERMODE UNAUTH, 


TAPI CAUSE BEARERMODE UNAVAIL, TAPI CAUSE BUSY, 


TAPI CAUSE CALLMETER EXPIRED, TAPI CAUSE CALLNO ERROR, TAPI CAUSE - 


CKTUNAVAIL, TAPI CAUSE CONGESTION, 


TAPI CAUSE NO CIRCUIT AVAIL, TAPI CAUSE DESTIN INCOMPAT, TAPI CAUSE - 


DTMF NOSPEECH, TAPI CAUSE DTMF REJECTED, 


TAPI CAUSE FACILITY NOTIMPL, TAPI CAUSE FACILITY NOTSUBSCRIBED, TAPI - 
CAUSE INCOMINGCUGCALLS BARRED, TAPI CAUSE INVALNUM, 


TAPI CAUSE MPTY ERROR, TAPI CAUSE NOANSWER, TAPI CAUSE - 
NONCUGMEMBER, TAPI CAUSE NUMBERCHANGED, 
TAPI CAUSE NUMBER ERROR, TAPI CAUSE NWFAILURE, TAPI CAUSE - 


OPERATIONUNAVAIL, TAPI CAUSE OUTOFORDER, 


TAPI CAUSE PROTOCOL ERROR, TAPI CAUSE QOSUNAVAIL, TAPI CAUSE REJECT, 


TAPI CAUSE REJ FAIL, 


ТАРІ CAUSE КЕЈ SRVC NOT АУ, ТАРІ CAUSE REMOTE CKTUNAVAIL, ТАРІ - 


CAUSE RESOURCEUNAVAIL, TAPI CAUSE SERVICEID ERROR, 
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ТАРІ CAUSE SERVICE NOTIMPL, ТАРІ CAUSE SERVICE UNAVAIL, ТАРІ CAUSE - 
MODIFY SAME BEARER, TAPI CAUSE MODIFY NOT PERMITTED, 


TAPI CAUSE HOLD FAIL, TAPI CAUSE TEMPFAILURE, TAPI CAUSE WRONGNUM, 
TAPI CAUSE NORMAL UNSPECIFIED, 

TAPI CAUSE SSERRINVALIDTIVALUE, TAPI CAUSE SSERRINVALIDTI, TAPI CAUSE - 
SSINCOMPATIBLESTATE, TAPI CAUSE SSERRSYNTAXERROR, 

TAPI CAUSE SSPROTOCOLERROR, ТАРІ CAUSE SSNEGATIVEPASSWORDCHECK, 
ТАРІ CAUSE SSSENTASPHASEI, ТАРІ CAUSE SSERROR, 

TAPI CAUSE SS USSD BUSY, TAPI CAUSE IDLE, TAPI CAUSE NETWORK SPECIFIC, 
TAPI CAUSE FADE, 

TAPI CAUSE UNKNOWN, ТАРІ CAUSE INCOM CALL, ТАРІ CAUSE ALERT STOP, 
TAPI CAUSE INTERCEPT, 

TAPI CAUSE REORDER, TAPI CAUSE CLIENT END, TAPI CAUSE ACCESS CLASS - 
BLOCKED, TAPI CAUSE MEMCAPEXCEEDED, 

ТАРІ CAUSE TYPENOTSUPPORTED, ТАРІ CAUSE REPLACENOTSUPPORTED, ТАРІ - 
CAUSE PROTOCOLID ERROR, TAPI CAUSE CLASSNOTSUPPORTED, 


TAPI CAUSE DATACODING ERROR, TAPI CAUSE INVAL MSG, TAPI CAUSE CALL - 
BARRED, TAPI CAUSE SIM CALL CONTROL CHANGED TO SS, 


TAPI CAUSE SIM CALL CONTROL CHANGED TO CALL, TAPI CAUSE SIM ERROR, 
TAPI CAUSE SIM CALL CONTROL MODIFIED, TAPI CAUSE RANDOM ACCESS - 
FAILURE, 
TAPI CAUSE LOWER LAYER FAILURE, ТАРІ CAUSE ACCESS REJECTED, ТАРІ - 
CAUSE REEST NOT ALLOWED, TAPI CAUSE EMERGENCY CALL NOT ALLOWED, 


TAPI CAUSE ACCESS NOT ALLOWED, TAPI CAUSE RADIO LINK FAILURE, TAPI - 
CAUSE INVALID IDENTITY, TAPI CAUSE UNKNOWN IDENTITY, 

TAPI CAUSE UNACCEPTABLE IDENTITY, TAPI CAUSE NO SERVICE HERE, TAPI - 
CAUSE SERVICE NOT ALLOWED, TAPI CAUSE SERVICE NOT AVAIL, 

TAPI CAUSE SERVICE NOT WORKING, TAPI CAUSE CANNOT IDENTIFY CALL, 
TAPI CAUSE DEACTIVATION, TAPI CAUSE FATAL ERROR } 

enum TelCallAnswerType t { ТАРІ CALL ANSWER ACCEPT = 0, ТАРІ CALL ANSWER - 
REJECT = 1 } 

enum TelCallType t ( TAPI CALL TYPE VOICE, TAPI CALL TYPE DATA, TAPI CALL - 
TYPE E911 } 

enum TelCallAlertingPattern t { 


ТАРІ CALL ALERTING PATTERN 1 = 0x00, ТАРІ CALL АГЕКТІМС PATTERN 2 = 0x01, 
ТАРІ САШ, ALERTING PATTERN 3 = 0x02, ТАРІ CALL ALERTING PATTERN 4 = 0x03, 


ТАРІ CALL ALERTING PATTERN 5 = 0x04, ТАРІ CALL АГЕКТІМС PATTERN 6 = 0x05, 
ТАРІ CALL ALERTING PATTERN 7 = 0x06, ТАРІ CALL ALERTING PATTERN 8 = 0x07, 
TAPI CALL NO ALERTING PATTERN = 0x08 } 

enum  TelCallActivestate t { ТАРІ CALL CONNECT IDLE, ТАРІ CALL CONNECT - 
ACTIVE, TAPI CALL CONNECT HELD ] 

enum TelCallIdentityMode t ( TAPI CALL IDENTITY DEFAULT, TAPI CALL IDENTITY - 
SHOW, TAPI CALL IDENTITY HIDE } 

enum TelCallCugOptions t { TAPI CALL CUG NO INFO = 0x00, TAPI CALL CUG - 
SUPRESS OA, ТАРІ CALL СОС SUPRESS РКЕ СОС, ТАРІ CALL СОС SUPRESS OA - 
AND ССС) 

enum TelCallUusType t ( TAPI CALL UUS NONE, TAPI CALL UUS 1) 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.91 Call Data Structures 


167 


* enum TelCallUusProtocolType t { 


TAPI CALL UUS PROTO SPECIFIC - 0, TAPI CALL UUS PROTO OSI HIGHER LAYER 
= 1, ТАРІ CALL UUS PROTO IA5 CHARS = 4, ТАРІ CALL UUS PROTO V120 = 7, 


TAPI CALL UUS PROTO 0931-8) 


RESTRICTED = 3 } 


5.91.1 Define Documentation 


5.91.1111  #define TAPI_CALL_UUS_DATA_LEN_MAX 131 


The Maximum length of the user to user signaling data string. 


5.91.1.2 #define ТАРІ CALLING NAME SIZE MAX 80 


The maximum length of the string for calling party name. 


5.91.2 Enumeration Type Documentation 


5.91.2.1 enum TelCallActiveState_t 


State of the current call. 


Enumerator: 


TAPI CALL CONNECT IDLE Call is in Idle state. 
ТАРІ CALL CONNECT ACTIVE Сай is in Active state. 
ТАРІ CALL CONNECT HELD Call is in Held state. 


5.91.2.2 enum TelCallAlertingPattern t 


This enumeration defines the different alerting patterns available. 


Enumerator: 
TAPI CALL ALERTING PATTERN 1 
TAPI CALL ALERTING PATTERN 2 
TAPI CALL ALERTING PATTERN 3 
TAPI CALL ALERTING PATTERN 4 
TAPI CALL ALERTING PATTERN 5 
TAPI CALL ALERTING PATTERN 6 
TAPI CALL ALERTING PATTERN 7 
TAPI CALL ALERTING PATTERN 8 


Pattern 1 
Pattern 2 
Pattern 3 
Pattern 4 
Pattern 5 
Pattern 6 
Pattern 7 


Pattern 8 


enum TelCallNameMode t { ТАРІ CALL NAME AVAIL = 0, ТАРІ CALL NAME - 
RESTRICTED = 1, TAPI CALL NAME UNAVAIL 


2, TAPI CALL NAME AVAIL - 


TAPI CALL NO ALERTING PATTERN No Alerting Pattern 
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5.91.2.3 enum TelCallAnswerType t 
Answer type used as in parameter in the answer call API. 


Enumerator: 


TAPI CALL ANSWER ACCEPT Used to answer an incoming call when there are no current ac- 
tive calls. 


TAPI CALL ANSWER REJECT Used to reject the incoming call 


5.91.2.4 enum TelCallCause t 


This structure defines the values for Call Cause. 


Enumerator: 


TAPI CAUSE SUCCESS Success 

TAPI CAUSE ACCESSDISCARD Access discarded 

TAPI CAUSE BARR BYOPERATOR Barred by operator 

TAPI CAUSE BEARERMODE NOTIMPL Bearer mode not implemented 
TAPI CAUSE BEARERMODE RESTRICTED  Bearer mode restricted 
TAPI CAUSE BEARERMODE UNAUTH  Bearer mode un authorized 
ТАРІ CAUSE BEARERMODE UNAVAIL Bearer mode not available 
ТАРІ CAUSE BUSY (Network/Server) busy 

TAPI CAUSE CALLMETER EXPIRED Call meter expired 

TAPI CAUSE CALLNO ERROR Call number error 

TAPI CAUSE CKTUNAVAIL Circuit channel unavailable 

TAPI CAUSE CONGESTION Congestion happened 

TAPI CAUSE NO CIRCUIT AVAIL Circuit not available 

TAPI CAUSE DESTIN INCOMPAT Destination incompatibility 

TAPI CAUSE DTMF NOSPEECH Хо speech in DTMF 

TAPI CAUSE DTMF REJECTED DTMF rejected 

TAPI CAUSE FACILITY NOTIMPL Facility not implemented 

TAPI CAUSE FACILITY NOTSUBSCRIBED Facility not subscribed 
TAPI CAUSE INCOMINGCUGCALLS BARRED Incoming CUG Calls barred 
TAPI CAUSE INVALNUM Invalid number 

TAPI CAUSE MPTY ERROR Multiparty error 

ТАРІ CAUSE NOANSWER Мо answer 

TAPI CAUSE NONCUGMEMBER Non CUG member 

TAPI CAUSE NUMBERCHANGED Number changed 

TAPI CAUSE NUMBER ERROR Number error 

TAPI CAUSE NWFAILURE Network failure 

TAPI CAUSE OPERATIONUNAVAIL Operation not available 

TAPI CAUSE OUTOFORDER Out of order 

TAPI CAUSE PROTOCOL ERROR Protocol error 
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TAPI CAUSE QOSUNAVAIL QOS unavailable 

TAPI CAUSE REJECT Rejected 

TAPI CAUSE REJ FAIL Rejection failed 

ТАРІ CAUSE КЕЈ SRVC NOT AVL Rejection service not available 
TAPI CAUSE REMOTE CKTUNAVAIL Remote Circuit channel unavailable 
TAPI CAUSE RESOURCEUNAVAIL Resource not available 

TAPI CAUSE SERVICEID ERROR Service id error 

TAPI CAUSE SERVICE NOTIMPL Service not implemented 

TAPI CAUSE SERVICE UNAVAIL Service not available 

TAPI CAUSE MODIFY SAME BEARER Modify same bearer 

TAPI CAUSE MODIFY NOT PERMITTED Modification not permitted 
TAPI CAUSE HOLD FAIL Call hold fail 

TAPI CAUSE TEMPFAILURE Temporary failure 

TAPI CAUSE WRONGNUM Wrong number 

TAPI CAUSE NORMAL UNSPECIFIED Normal but unspecified 

TAPI CAUSE SSERRINVALIDTIVALUE SS invalid Transaction ID Value 
TAPI CAUSE SSERRINVALIDTI SS Invalid transaction ID 

TAPI CAUSE SSINCOMPATIBLESTATE SS incompatible state 

TAPI CAUSE SSERRSYNTAXERROR SS syntax error 

TAPI CAUSE SSPROTOCOLERROR Protocol error 

ТАРІ CAUSE SSNEGATIVEPASSWORDCHECK Negative password check 
ТАРІ CAUSE SSSENTASPHASEI SS sent as phasel message 

TAPI CAUSE SSERROR Supplementary service error 


TAPI CAUSE SS USSD BUSY Second USSD request will be rejected when already USSD trans- 
action is ongoing. 


TAPI CAUSE IDLE Idle 

TAPI CAUSE NETWORK SPECIFIC Network specific error 
TAPI CAUSE FADE voice call was dropped e.g. because of a loss of signal 
TAPI CAUSE UNKNOWN unknown no details available 

TAPI CAUSE INCOM CALL terminated by incoming call 

TAPI CAUSE ALERT STOP terminated by alert stop 

TAPI CAUSE INTERCEPT voice call was dropped by interception 
TAPI CAUSE REORDER voice call was dropped by reordering 
TAPI CAUSE CLIENT END client ended the call 

TAPI CAUSE ACCESS CLASS BLOCKED access class blocked 
TAPI CAUSE MEMCAPEXCEEDED Memory capacity exceeded 
TAPI CAUSE TYPENOTSUPPORTED Type not supported 

TAPI CAUSE REPLACENOTSUPPORTED Replace not supported 
TAPI CAUSE PROTOCOLID ERROR Protocol id error 

TAPI CAUSE CLASSNOTSUPPORTED Class not supported 

TAPI CAUSE DATACODING ERROR Data coding error 
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TAPI CAUSE INVAL MSG Invalid message 

TAPI CAUSE CALL BARRED Call barred 

ТАРІ CAUSE SIM CALL CONTROL CHANGED TO SS Sim call control changed to SS 
TAPI CAUSE SIM CALL CONTROL CHANGED TO CALL SIM Call control changed to call 


TAPI CAUSE SIM ERROR SIM error 

TAPI CAUSE SIM CALL CONTROL MODIFIED SIM call control modified 
TAPI CAUSE RANDOM ACCESS FAILURE Random access error 

TAPI CAUSE LOWER LAYER FAILURE Lower layer error 

TAPI CAUSE ACCESS REJECTED Access rejected 

TAPI CAUSE REEST NOT ALLOWED Reset not allowed 

TAPI CAUSE EMERGENCY CALL NOT ALLOWED Emergency call not allowed 
TAPI CAUSE ACCESS NOT ALLOWED Access not allowed 

TAPI CAUSE RADIO LINK FAILURE Radio link failure 

TAPI CAUSE INVALID IDENTITY Invalid identity 

TAPI CAUSE UNKNOWN IDENTITY Unknown identity 

TAPI CAUSE UNACCEPTABLE IDENTITY Un acceptable identity 

TAPI CAUSE NO SERVICE HERE No service here 

TAPI CAUSE SERVICE NOT ALLOWED Service not allowed 

TAPI CAUSE SERVICE NOT AVAIL Service not available 

TAPI CAUSE SERVICE NOT WORKING Service not working 

TAPI CAUSE CANNOT IDENTIFY CALL Cannot identify the call 

ТАРІ CAUSE DEACTIVATION Deactivation 

TAPI CAUSE FATAL ERROR Fatal error 


5.91.2.5 enum TelCallCugOptions t 


This enumeration defines the closed user group options 


Enumerator: 


TAPI CALL CUG NO INFO No information 

TAPI CALL CUG SUPRESS OA suppress OA 

TAPI CALL CUG SUPRESS PRF CUG suppress preferential CUG 

TAPI CALL CUG SUPRESS OA AND CUG suppress OA and preferential CUG 


5.91.2.6 enum TelCallIdentityMode t 


This enumeration defines the identity mode option for a call 


Enumerator: 


TAPI CALL IDENTITY DEFAULT Calling line identity will be sent. Based on network setting, 
Line identity will presented to the called party. 


TAPI CALL IDENTITY SHOW Display calling line identity 
TAPI CALL IDENTITY HIDE Hide the display of Calling line identity 
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5.91.2.7 enum TelCallNameMode t 


This enumeration defines the call name mode 


Enumerator: 


TAPI CALL NAME AVAIL This identifier refers to the presentation of the calling party's name 
identity to the called party. 


TAPI CALL NAME RESTRICTED This identifier refers to the restriction of presentation of the 
name identity of the calling party to the called party. 


TAPI CALL NAME UNAVAIL This identifier refers to the unavailability of the calling party's 
name identity to be offered to the called party. 


TAPI CALL NAME AVAIL RESTRICTED This identifier refers to the calling party's name iden- 
tity to be offered to the called party with which presentation restriction is overridden. 


5.91.2.8 enum TelCallType t 


Applications needs to use this call type while using the setip call API. Like the requested call is a voice call 
or video call. 


Enumerator: 


TAPI CALL TYPE VOICE Voice call type. 
TAPI CALL TYPE DATA Data call type - (for modem, fax, packet, etc. calls). 
TAPI CALL TYPE E911 Emergency call type. 


5.91.2.9 enum TelCallUusProtocolType t 
This enumeration defines the tapi call uus protocol types 


Enumerator: 


TAPI CALL UUS PROTO SPECIFIC The user information is structured according to user needs. 


ТАРІ CALL UUS РКОТО OSI HIGHER LAYER OSI high layer protocols 

ТАРІ CALL UUS PROTO ІА5 CHARS user information consists of IA5 characters 
TAPI CALL UUS PROTO VI20 rate adaptation 

TAPI CALL UUS PROTO 0931 user-network call control messages 


5.91.2.10 enum TelCallUusType t 
This enumeration defines the UUS Type 


Enumerator: 
TAPI CALL UUS NONE No User to User information 
ТАРІ CALL UUS 1 User to User information 1 
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5.92 NetText Data Structures 


Files 


* file TelNetText.h 


This file serves as a "C" header file defines structures for Tapi Network Text Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelSmsCbConfig t 
struct TelSmsAddressInfo t 


struct TelSmsParams t 


struct TelSmsDatapackageInfo_t 
struct TelSmsData t 

struct TelSmsStoredMsgCountInfo_t 
struct TelSmsCbMsg t 


Defines 


fdefine TAPI NETTEXT CB PAGE SIZE MAX 93 

fdefine TAPI NETTEXT GSM SMS MSG NUM MAX 90 

fdefine TAPI NETTEXT GSM SMS CBMI LIST SIZE MAX 60 

#define TAPI NETTEXT SMDATA SIZE MAX 160 

#define TAPI NETTEXT MAX GSM SMS SERVICE CENTER ADDR 12 
#define TAPI NETTEXT MAX INDEX 255 

#define TAPI SIM SMSP ADDRESS LEN 20 

fdefine TAPI SIM SMSP ALPHA ID LEN MAX 32 


Enumerations 


• enum TelSmsMsgStatus_t { 


TAPI NETTEXT STATUS READ, TAPI NETTEXT STATUS UNREAD, TAPI NETTEXT - 
STATUS SENT, TAPI NETTEXT STATUS UNSENT, 


TAPI NETTEXT STATUS DELIVERED, TAPI NETTEXT STATUS DELIVERY - 
UNCONFIRMED, TAPI NETTEXT STATUS MESSAGE REPLACED, ТАРІ NETTEXT - 
STATUS RESERVED } 


enum TelSmsBearerType t ( 
TAPI NETTEXT BEARER PS ONLY = 0x01, TAPI NETTEXT BEARER CS ONLY, TAPI - 
NETTEXT BEARER PS PREFERRED, TAPI NETTEXT BEARER CS PREFERRED, 


TAPI NETTEXT NO PREFERRED BEARER } 


enum TelSmsCbMsgType t { ТАРІ NETTEXT CB MSG CBS = 1, ТАРІ NETTEXT - 
СВ МС SCHEDULE, ТАРІ NETTEXT CB MSG СВ541, ТАРІ NETTEXT CB MSG - 
INVALID } 
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* enum TelSmsResponse t { 


ТАРІ NETTEXT SENDSMS SUCCESS = 0x00, TAPI NETTEXT ROUTING NOT - 
AVAILABLE, TAPI NETTEXT INVALID PARAMETER, TAPI NETTEXT DEVICE - 
FAILURE, 


ТАРІ NETTEXT SERVICE RESERVED, ТАРІ NETTEXT INVALID LOCATION, ТАРІ - 
NETTEXT NO SIM, TAPI NETTEXT SIM NOT READY, 


TAPI NETTEXT NO NETWORK RESP, TAPI NETTEXT DEST ADDRESS FDN - 
RESTRICTED, ТАРІ NETTEXT SCADDRESS FDN RESTRICTED, ТАРІ NETTEXT - 
RESEND ALREADY DONE, 


TAPI NETTEXT SCADDRESS NOT AVAILABLE, TAPI NETTEXT UNASSIGNED - 
NUMBER, ТАРІ NETTEXT OPERATOR DETERMINED BARRING, ТАРІ NETTEXT - 
CALL BARRED, 


TAPI NETTEXT MESSAGE TRANSFER REJECTED, TAPI NETTEXT MEMORY - 
CAPACITY EXCEEDED, ТАРІ NETTEXT DESTINAITION OUTOFSERVICE, ТАРІ - 
NETTEXT UNSPECIFIED SUBSCRIBER, 


TAPI NETTEXT FACILITY REJECTED, TAPI NETTEXT UNKNOWN SUBSCRIBER, 
TAPI NETTEXT NETWORK. OUTOFORDER, TAPI NETTEXT TEMPORARY FAILURE, 


TAPI NETTEXT CONGESTION, TAPI NETTEXT RESOURCES UNAVAILABLE, 
TAPI NETTEXT FACILITY NOT SUBSCRIBED, TAPI NETTEXT FACILITY NOT - 
IMPLEMENTED, 


TAPI NETTEXT INVALID REF VALUE, TAPI NETTEXT INVALID MSG, TAPI - 
NETTEXT INVALID MANDATORY INFO, TAPI NETTEXT MESSAGE TYPE NOT - 


IMPLEMENTED, 

TAPI NETTEXT MESSAGE NOT COMPAT PROTOCOL, TAPI NETTEXT IE - 
NOT IMPLEMENTED, TAPI NETTEXT PROTOCOL ERROR, TAPI NETTEXT - 
INTERWORKING } 


enum TelSmsCause_t { 


ТАРІ NETTEXT SUCCESS, ТАРІ NETTEXT INVALID PARAMETER FORMAT, ТАРІ - 
NETTEXT PHONE FAILURE, ТАРІ NETTEXT SIM. BUSY, 


TAPI NETTEXT SIM FAILURE, TAPI NETTEXT UNKNOWN, TAPI NETTEXT - 
MEMORY FAILURE, TAPI NETTEXT OPERATION NOT SUPPORTED } 


5.92.1 Define Documentation 


5.92.1.1 #define ТАРІ NETTEXT CB PAGE SIZE MAX 93 


CB maximum page size 


5.92.1.2 #define ТАРІ NETTEXT СМ SMS CBMI LIST SIZE MAX 60 


Maximum GSM SMS СВМІ list size 


5.92.1.3 #define ТАРІ МЕТТЕХТ СМ SMS MSG NUM MAX 90 


Maximum GSM SMS message number 
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5.92.1.4 #аебпе ТАРІ NETTEXT SMDATA SIZE МАХ 160 


Maximum SMS data size that can be stored 


5.92.1.5 #define ТАРІ SIM SMSP ADDRESS LEN 20 


digit length 


5.92.1.6 #define ТАРІ SIM SMSP ALPHA ID LEN MAX 32 


alpha id length 


5.92.2 Enumeration Type Documentation 
5.02.2.1 enum TelSmsBearerType t 
This enum defines the different bearer types 


Enumerator: 
TAPI NETTEXT BEARER PS ONLY Send SMS only on PS Bearer 
TAPI NETTEXT BEARER CS ONLY Send SMS only on CS Bearer 
TAPI NETTEXT BEARER PS PREFERRED Send SMS preferably on PS Bearer 
TAPI NETTEXT BEARER CS PREFERRED Send SMS preferably on CS Bearer 


TAPI NETTEXT NO PREFERRED BEARER SMS is sent based on default preferred bearer set 
at OEM based on vendor/operator preference 


5.92.2.2 enum TelSmsCause_t 


This enum defines the differnet cause types that come in the sent status acknowledgement/notification after 
sending a message to the network 


Enumerator: 
TAPI_NETTEXT_SUCCESS Sms Operation successful 


TAPI NETTEXT INVALID PARAMETER FORMAT Invalid format for some parameters 
passed in Datapackage information(TPDU) 


ТАРІ NETTEXT PHONE FAILURE SMS operation failed due to Modem failure 


TAPI NETTEXT SIM BUSY SMS SIM operation cannot be performed as SIM is busy with some 
other operation 


TAPI NETTEXT SIM FAILURE SMS SIM operation cannot be performed due to sim failure 
TAPI NETTEXT UNKNOWN unknown error 


TAPI NETTEXT MEMORY FAILURE Error while accessing memory or allocation of memory 
for SMS operation. 


TAPI NETTEXT OPERATION NOT SUPPORTED operation not allowed/supported 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


5.92 NetText Data Structures 175 


5.92.2.3 enum Tel8msCbMsgType t 
This enumeration defines the different CB message types. 


Enumerator: 


TAPI NETTEXT CB MSG CBS Cell broadcast message 

TAPI NETTEXT CB MSG SCHEDULE CB Schedule message 
TAPI NETTEXT CB MSG CBS41 CBS41 type message 

TAPI NETTEXT CB MSG INVALID Invalid CB message 


5.02.2.4 enum TelSmsMsgStatus t 
This enumeration defines the network text status type. 


Enumerator: 


TAPI NETTEXT STATUS READ MT message, stored and read 

TAPI NETTEXT STATUS UNREAD MT message, stored and unread 
TAPI NETTEXT STATUS SENT MO message, stored and sent 

TAPI NETTEXT STATUS UNSENT MO message, stored but not sent 
TAPI NETTEXT STATUS DELIVERED delivered destination 


TAPI NETTEXT STATUS DELIVERY UNCONFIRMED Service centre forwarded message 
but is unable to confirm delivery 


TAPI NETTEXT STATUS MESSAGE REPLACED Message has been replaced 
TAPI NETTEXT STATUS RESERVED Reserved for future use 


5.92.2.5 enum TelSmsResponse t 


This enum defines the different response types that come in the sent status acknowledgement/notification 
after sending a message to the network 


Enumerator: 


TAPI NETTEXT SENDSMS SUCCESS Message send success 

TAPI NETTEXT ROUTING NOT AVAILABLE Message routing not available 

TAPI NETTEXT INVALID PARAMETER Invalid parameter present in TPDU 

TAPI NETTEXT DEVICE FAILURE Device failure 

TAPI NETTEXT SERVICE RESERVED Reserved Service 

TAPI NETTEXT INVALID LOCATION Invalid location 

TAPI NETTEXT NO SIM No sim error 

TAPI NETTEXT SIM NOT READY Sim not ready error 

TAPI NETTEXT NO NETWORK RESP No response from network 

TAPI NETTEXT DEST ADDRESS FDN RESTRICTED Destination address restricted 
TAPI NETTEXT SCADDRESS FDN RESTRICTED Service center address restricted 
TAPI NETTEXT RESEND ALREADY DONE  Resend operation already done 
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TAPI NETTEXT SCADDRESS NOT AVAILABLE SCA address not available 

TAPI NETTEXT UNASSIGNED NUMBER Unassigned number 

TAPI NETTEXT OPERATOR DETERMINED BARRING Operator determined barring 

TAPI NETTEXT CALL BARRED Call barred 

TAPI NETTEXT MESSAGE TRANSFER REJECTED Message transfer rejected 

TAPI NETTEXT MEMORY CAPACITY EXCEEDED Memory capacity exceeded/memory full 


ТАРІ NETTEXT DESTINAITION OUTOFSERVICE Destination number/address out of ser- 


vice 
TAPI NETTEXT UNSPECIFIED SUBSCRIBER  Unspecified subscriber 
TAPI NETTEXT FACILITY REJECTED Facility rejected 
TAPI NETTEXT UNKNOWN SUBSCRIBER Unknown subscriber 
TAPI NETTEXT NETWORK OUTOFORDER Network out of order 
TAPI NETTEXT TEMPORARY FAILURE Temporary failure 
TAPI NETTEXT CONGESTION Congestion happened 
TAPI NETTEXT RESOURCES UNAVAILABLE Resource unavailable 
TAPI NETTEXT FACILITY NOT SUBSCRIBED Facility not subscribed by the user 
TAPI NETTEXT FACILITY NOT IMPLEMENTED Facility not implemented 
TAPI NETTEXT INVALID REF VALUE Invalid reference value 
TAPI NETTEXT INVALID MSG Invalid message 
TAPI NETTEXT INVALID MANDATORY INFO Invalid mandatory information 
TAPI NETTEXT MESSAGE TYPE NOT IMPLEMENTED Message type not implemented 
TAPI NETTEXT MESSAGE NOT COMPAT PROTOCOL Message not compact protocol 
TAPI NETTEXT IE NOT IMPLEMENTED Information element not implemented 
TAPI NETTEXT PROTOCOL ERROR Protocol error 
TAPI NETTEXT INTERWORKING Networking error 
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5.93 Network Data Structures 


Files 


* file TelNetwork.h 


This file serves as a "C" header file defines structures for Tapi Network Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelNetworkTimeAndZone t 
struct TelNetworkSystemlId t 
struct TelNetworkConfigSettings t 
struct TelNetworkInfo t 

struct TelNetworkList t 

struct TelNetworkRadioInfo t 


Defines 


• #define ТАРІ NETWORK ORDER MAX 5 

* #define TAPI NETWORK LIST MAX 15 

• #define ТАРІ NETWORK NAME LEN MAX 40 
• #define ТАРІ NETWORK SPN LEN MAX 20 


Enumerations 


enum ‘TelNetworkSelectionMode_t { ТАРІ NETWORK. SELECTIONMODE AUTOMATIC, 
TAPI NETWORK SELECTIONMODE MANUAL } 


enum  TelNetworkSystemIdFormat t { ТАРІ NETWORK SYSID FORMAT 51р, ТАРІ - 
NETWORK, SYSID FORMAT PLMN } 


enum TelNetworkServiceDomain t { ТАРІ NETWORK, SERVICE DOMAIN COMBINED, 
ТАРІ NETWORK. SERVICE DOMAIN. PS, ТАРІ NETWORK. SERVICE DOMAIN. CS, 
TAPI NETWORK, SERVICE DOMAIN AUTOMATIC } 


enum TelNetworkMode t ( 

TAPI NETWORK MODE EMERGENCY, TAPI NETWORK. MODE AUTOMATIC, TAPI - 
NETWORK. MODE CDMA, TAPI NETWORK. MODE GSM, 

TAPI NETWORK, MODE WCDMA, TAPI NETWORK, MODE WLAN } 


enum  TelNetworkServiceLevel t { ТАРІ NETWORK SERVICE LEVEL МО, TAPI - 
NETWORK, SERVICE LEVEL EMERGENCY, ТАРІ NETWORK SERVICE LEVEL ЕСТІ, 
ТАРІ NETWORK, SERVICE LEVEL, SEARCH } 


enum TelNetworkServiceType t { 


TAPI NETWORK SERVICE TYPE NO SVE, TAPI NETWORK SERVICE TYPE - 
LIMITED, ТАРІ NETWORK. SERVICE TYPE CS, ТАРІ NETWORK SERVICE TYPE PS, 


TAPI NETWORK SERVICE TYPE COMBINED } 
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enum TelNetworkSystemType t { 


TAPI NETWORK SYSTEM NO SRV, TAPI NETWORK SYSTEM CDMA, TAPI - 


NETWORK SYSTEM TDMA, TAPI NETWORK SYS 


TEM. GSM, 


TAPI NETWORK SYSTEM GPRS, TAPI NETWORK SYSTEM EGPRS, TAPI - 
NETWORK SYSTEM РС51900, ТАРІ NETWORK SYSTEM UMTS, 


ТАРІ NETWORK, SYSTEM, GSM, AND ОМТ } 
enum TelNetworkBandPreferred t { TAPI NETWORK 


BAND MODE PREFERRED = 0x01, 


TAPI NETWORK, BAND MODE ONLY = 0x02 } 
enum TelNetworkBand. t { 


TAPI NETWORK BAND TYPE ANY - 0x00, TAPI NETWORK BAND TYPE GSMS50, 


TAPI NETWORK BAND TYPE GSM 900 1800, 
GSM1900, 


TAPI NETWORK BAND TYPE - 


TAPI NETWORK BAND TYPE GSM, TAPI NETWORK BAND TYPE WCDMA, TAPI - 
NETWORK BAND TYPE WCDMAS50, ТАРІ NETWORK BAND TYPE WCDMAI900, 


ТАРІ NETWORK BAND TYPE WCDMA2100 } 
enum TelNetworkOperationCause t { 


ТАРІ NETWORK NO ERR = 0x00, ТАРІ NETWORK OPERATION FAILED, ТАРІ - 
NETWORK PHONE IN USE ERR, TAPI NETWORK OFFLINE ERR, 


ТАРІ NETWORK CONFIG SETTINGS FAILURE ERR, ТАРІ NETWORK INTERNAL - 


FAILURE ERR } 


TAPI NETWORK. DLS ADJ PLUS. ONE HOUR, 
HOUR } 


5.93.1 Define Documentation 
5.93.1.1 #define ТАРІ NETWORK LIST MAX 15 


Maximum network list 


5.93.1.2 #define ТАРІ NETWORK NAME LEN MAX 40 


Maximum network name or PLMN name length 


5.93.1.3 ffdefine ТАРІ NETWORK ORDER МАХ 5 


Maximum network order 


5.93.1.4 #define ТАРІ NETWORK SPN LEN MAX 20 


Maximum network service provider name length 


5.93.2 Enumeration Type Documentation 
5.93.2.1 enum TelNetworkBand t 


This enumeration defines different network Bands. 


enum TelNetworkDayLightSavingAdj t { TAPI NETWORK DLS ADJ NO ADJUSTMENT, 


TAPI NETWORK DLS PLUS TWO - 
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Enumerator: 
TAPI NETWORK BAND TYPE ANY АП bands can be tried. 
ТАРІ NETWORK BAND TYPE 68М850 This member sets the band to GSM 850 
TAPI NETWORK BAND TYPE GSM 900 1800 This member sets the band to GSM 900 1800 
ТАРІ NETWORK BAND TYPE GSMI900 GSM 1900 
TAPI NETWORK BAND TYPE GSM This member sets all GSM bands 
TAPI NETWORK BAND TYPE WCDMA This member sets all WCDMA bands 
ТАРІ NETWORK BAND TYPE WCDMAGSS0 This member sets the band to WCDMA 850 
ТАРІ NETWORK BAND TYPE WCDMAI900 This member sets the band to WCDMA 1900 
TAPI NETWORK BAND TYPE WCDMA2100 This member sets the band to WCDMA 2100 


5.93.2.2 enum TelNetworkBandPreferred t 
This enumeration defines the opeartions that can be done on network Band. 


Enumerator: 


TAPI NETWORK BAND MODE PREFERRED Preferred band. (If preferred Band is not avail- 
able, then underlying modem can search on other bands) 


TAPI NETWORK BAND MODE ONLY This allows only particular band. 


5.93.2.3 enum TelNetworkDayLightSavingAdj t 
This enumeration defines the day light saving adjustment time. 


Enumerator: 
TAPI NETWORK DLS ADJ NO ADJUSTMENT No adjustment specified on day light saving 
TAPI NETWORK DLS ADJ PLUS ONE HOUR Day light saving adjusted for one hour 
TAPI NETWORK DLS PLUS TWO HOUR Day light saving adjusted for two hours 


5.03.2.4 enum TelNetworkMode t 


This enumeration defines the network modes. 


Enumerator: 


TAPI NETWORK MODE EMERGENCY This member sets the emergency network mode 


TAPI NETWORK MODE AUTOMATIC This member sets the automatic network mode. Based 
on OEM priority, nw mode preference will be used 


TAPI NETWORK MODE CDMA This member sets the network mode to CDMA 
TAPI NETWORK MODE GSM This member sets the network mode to GSM 

TAPI NETWORK MODE WCDMA This member sets the network mode to WCDMA 
TAPI NETWORK MODE WLAN This member sets the network mode to WLAN 
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5.03.2.5 enum TelNetworkOperationCause t 
This enumeration defines different network operation cause. 


Enumerator: 
TAPI NETWORK NO ERR There is no error for any network operation. 
TAPI NETWORK OPERATION FAILED There is no error for any network operation. 


TAPI NETWORK PHONE IN USE ERR This error will be returned when any network opera- 
tion is tried while phone is in use(eg, Voice / Data call in progress due to which network operation 
failed) 


TAPI NETWORK OFFLINE ERR This error is sent when any network option is tried when 
phone is in offline mode 


TAPI NETWORK CONFIG SETTINGS FAILURE ERR This error is sent when modem is un- 
able to process the config settings information. 


TAPI NETWORK INTERNAL FAILURE ERR This error to indicate internal failure 


5.93.2.6 enum TelNetworkSelectionMode t 


This enumeration defines the network selection modes. 


Enumerator: 


TAPI NETWORK SELECTIONMODE AUTOMATIC Network selection is in Automatic selec- 
tion mode 


TAPI NETWORK SELECTIONMODE MANUAL Network selection is in Manual selection 
mode 


5.93.27 enum TelNetworkServiceDomain t 


This enumeration defines the network service domains . 


Enumerator: 


TAPI NETWORK SERVICE DOMAIN COMBINED This member sets the Circuit switch and 
Packet Switch domain 


TAPI NETWORK SERVICE DOMAIN PS This member sets the Packet Switch service domain 
TAPI NETWORK SERVICE DOMAIN CS This member sets the Circuit Switch service domain 


TAPI NETWORK SERVICE DOMAIN AUTOMATIC This member sets the service domain to 
Circuit Switch and Packet Switch or Circuit Switch or Packet Switch domain 


5.93.2.8 enum TelNetworkServiceLevel t 


This enumeration defines the status of network service. 


Enumerator: 


TAPI NETWORK SERVICE LEVEL NO No service available in the network ME is camped 
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TAPI NETWORK SERVICE LEVEL EMERGENCY Only emergency service available in the 
network ME is camped 


TAPI NETWORK SERVICE LEVEL FULL FULL service available in the network ME is 
camped 


TAPI NETWORK SERVICE LEVEL SEARCH Searching for service 


5.93.2.9 enum TelNetworkServiceType t 
This enumeration defines the service types of TAPI. 


Enumerator: 


ТАРІ NETWORK SERVICE ТҮРЕ NO SVE Мо service (This enumeration is not applicable for 
ОЕМ TAPI NW select network req API) 


TAPI NETWORK SERVICE TYPE LIMITED Limited service available in the camped network 
(This enumeration is not applicable for ОЕМ TAPI NW select network req API) 


TAPI NETWORK SERVICE TYPE CS CS service available in the camped network 
TAPI NETWORK SERVICE TYPE PS PS service available in the camped network 


TAPI NETWORK SERVICE TYPE COMBINED Both CS and PS services available in the 
camped network 


5.93.2.10 enum TelNetworkSystemIdFormat_t 
This enumeration defines the System ID Formats. 


Enumerator: 


TAPI NETWORK SYSID FORMAT SID System ID in CDMA. 
TAPI NETWORK SYSID FORMAT PLMN PLMN id in GSM/3G 


5.93.2.11 enum TelNetworkSystemType t 
This enumeration defines the system types of TAPI. 


Enumerator: 


ТАРІ NETWORK SYSTEM NO SRV No Service available 

TAPI NETWORK SYSTEM CDMA Available service is CDMA 

TAPI NETWORK SYSTEM TDMA Available service is ТОМА 

TAPI NETWORK SYSTEM GSM Available service is GSM 

TAPI NETWORK SYSTEM GPRS Available service is GPRS 

TAPI NETWORK SYSTEM EGPRS Available service is EGPRS 

ТАРІ NETWORK SYSTEM PCS1900 Available service is PCS1900 band 

TAPI NETWORK SYSTEM UMTS Available service is UMTS 

TAPI NETWORK SYSTEM GSM AND UMTS Both GSM and UMTS systems available 
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5.94 SIM Data Structures 


Files 


* file TelSim.h 


This file serves as a "C" header file defines structures for Tapi SIM Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


* struct TelSimFileID t 

struct TelSimPinData t 

struct TelSimReadFileRequestData, t 
struct TelSimIccIdInfo. t 


struct TelSimImsiInfo t 


struct TelSimServiceTable t 


struct TelSimSstInfo t 


struct TelSimPinInfo t 

struct TelSimPb2gData t 
struct TelSimPbRecordData t 
struct TelSimEccInfo t 

struct TelUsimEccInfo t 
struct TelUSimServiceTable t 


struct TelSimUstInfo t 

struct TelSimPbStorageInfo t 
struct TelSimPbEntryInfo t 
struct TelSimPbReadResp t 
struct TelSimPbUpdateResp t 


struct TelSimLanguagelInfo t 
struct TelSimFileAccessGeneralResp t 


struct TelSimGroupldentifierInfo t 
struct TelSimEccData t 

struct TelSimStatusData t 

struct TelSimCallbackEvent t 
struct TelSimEvent t 

struct TelSimApnData t 


struct TelSimDeviceContextData t 


struct TelSimDeviceContext t 

struct TelSimFileInfo t 

struct TelSimReadFileData t 

struct TelSimUpdateFileRequestData t 
struct TelSimFileInfo t 
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Defines 


fdefine TAPI SIM PIN LENGTH 8 

#define TAPI SIM ICCIDLENGTH 10 

#define TAPI SIM ICCID PACKET LEN 10 

#define TAPI SIM ICCID MAX LEN 10 

#define TAPI SIM LP MAX LEN 30 

#define TAPI SIM LP PACKET MAX LEN 30 

#define ТАРІ SIM IMSI LEN 8 

#define TAPI SIM IMSI PACKET LEN 15 

#define ТАРІ SIM MCC CODE LEN 3 

#define TAPI SIM MNC CODE LEN 2 

#define TAPI SIM MSIN CODE LEN 10 

#define TAPI SIM NUM TEXT MAX LEN 256 

#define TAPI SIM SST MAX LEN 20 

#define TAPI SIM GSM SST SERVICE MAX COUNT 50 
fdefine TAPI SIM ECC CODE LEN 3 

fdefine TAPI SIM ECC ALPHA STRING LEN MAX 50 
#define ТАРІ TAPI SIM PBOOK ENTRY COUNT MAX 20 
fdefine TAPI SIM LI MAX LEN 30 

fdefine TAPI SIM LI PACKET MAX LEN 30 

#define TAPI SIM ACL MAX LEN 50 

#define TAPI SIM GROUP IDENTIFIER LEN MAX 10 
#define TAPI SIM ECC MAX LEN 15 

#define ТАРІ SIM UECC RECORD COUNT МАХ 5 
fdefine TAPI SIM UECC RECORD LEN MAX 50 


Enumerations 


enum TelSimCardType t ( TAPI SIM CARD TYPE UNKNOWN, TAPI SIM CARD TYPE - 
GSM, TAPI SIM CARD TYPE USIM } 

enum TelSimFileName t { 

TAPI SIM EFILE DIR = Ox2F00, TAPI SIM EFILE ICCID = Ox2FE2, TAPI SIM EFILE - 
ADN = 0x6F3A, ТАРІ SIM, EFILE FDN = 0x6F3B, 

TAPI SIM EFILE SMS = 0x6F3C, ТАРІ SIM. EFILE. CCP = 0x6F3D, TAPI SIM. ЕЕП,Е IMSI 
= 0х6Е07, ТАРІ SIM EFILE, SST = Ox6F38, 

TAPI SIM EFILE EST = 0х6Е56, ТАРІ SIM EFILE АСМ = 0х6Е39, TAPI SIM EFILE - 
MBDN = 0x6FC7, TAPI SIM  EFILE GIDI = Ox6F3E, 

TAPI SIM EFILE GID2 = Ox6F3F, TAPI SIM. EFILE. MSISDN = 0x6F40, TAPI SIM. EFILE - 
SMSP = 0x6F42, ТАРІ SIM EFILE, SMSS = Ox6F43, 

ТАРІ SIM EFILE ЕХТІ = 0x6F4A, TAPI SIM. ЕЕП,Е EXT2 = 0х6ҒАВ, TAPI SIM. EFILE LP 
= Ox2F05, ТАРІ SIM EFILE, ACM. MAX = 0x6F37, 

TAPI SIM EFILE РОСТ = 0х6Е41, ТАРІ SIM EFILE. CBMI = Ox6F45, ТАРІ SIM EFILE - 
PHASE = Ox6FAE, TAPI SIM. EFILE. SDN = Ox6F49, 

TAPI SIM EFILE EXT3 = 0x6F4C, ТАРІ SIM, EFILE BDN = 0х6ҒАр, TAPI SIM EFILE - 
EXTA = Ox6F4E, TAPI SIM, EFILE, ECC = 0x6FB7, 


TAPI SIM EFILE SPN = Ox6F46, ТАРІ SIM ЕЕП Е РММ = Ox6FC5, ТАРІ SIM EFILE IMG 
= Ox4F20, ТАРІ SIM EFILE USIM LI = 0x6F05, 
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ТАРІ SIM EFILE USIM IMSI = 0x6A07, ТАРІ SIM. EFILE USIM АСМ MAX = 0x6A37, 
TAPI SIM. EFILE USIM UST = 0x6A38, ТАРІ SIM EFILE USIM ACM = 0x6A39, 


TAPI SIM EFILE USIM SPN - 0x6A46, TAPI SIM EFILE USIM PUCT - 0x6A41, TAPI - 
SIM. EFILE USIM CBMI = 0x6A45, ТАРІ SIM EFILE USIM ECC = 0x6AB7, 


TAPI SIM EFILE USIM FDN = 0x6A3B, TAPI SIM EFILE USIM SMS = 0x6A3C, TAPI - 
SIM. EFILE USIM MSISDN = 0x6A40, ТАРІ SIM EFILE (ЗІМ SMSP = 0x6A42, 


TAPI SIM EFILE USIM SMSS = 0x6A43, ТАРІ SIM EFILE USIM SDN = 0x6A49, ТАРІ - 
SIM. EFILE USIM EXTI = 0X6A4A, ТАРІ SIM EFILE USIM EXT? = 0x6A4B, 


TAPI SIM EFILE USIM EXT3 = 0x6A4C, ТАРІ SIM ЕЕП Е USIM EXTA = 0x6A55, ТАРІ - 
SIM EFILE USIM ЕХТ5- 0x6A4E, ТАРІ SIM EFILE USIM ЕХТ6- 0x6FC8, 


ТАРІ SIM EFILE USIM CCP2 = 0x6A4F, ТАРІ SIM EFILE USIM HIDDEN KEY = 
Ox6FC3, ТАРІ SIM EFILE USIM BDN = 0х6А4р, ТАРІ SIM EFILE USIM MBDN 
Ox6FC7, 


ТАРІ SIM. EFILE USIM MBI = 0x6FC9, ТАРІ SIM EFILE USIM РНОМЕВООК РВК = 
Ox4FFO, ТАРІ SIM EFILE USIM PHONEBOOK ССРІ = Ox4FFE, ТАРІ SIM EFILE USIM - 
PHONEBOOK UID = 0x4FF8, 


TAPI SIM EFILE USIM PHONEBOOK PSC =  Ox4FFEB ТАРІ SIM EFILE ОІМ - 
PHONEBOOK CC = Ox4FEF, ТАРІ SIM EFILE USIM PHONEBOOK PUID = Ox4FEE, 
ТАРІ SIM. EFILE USIM PHONEBOOK ADN = 0x4FF1, 


TAPI SIM EFILE USIM PHONEBOOK ТАР =  Ox4FF2, TAPI SIM EFILE USIM - 
РНОМЕВООК РВС = 0х4ЕЕЗ, ТАРІ SIM EFILE USIM PHONEBOOK ЕХТІ = Ox4FFB, 
ТАРІ SIM. EFILE USIM РНОМЕВООК СКР = Ox4FF7, 


TAPI SIM EFILE USIM PHONEBOOK AAS =  Ox4FFC, ТАРІ SIM EFILE USIM - 
PHONEBOOK_AAS1 = Ox4FFD, ТАРІ SIM EFILE USIM PHONEBOOK GAS = O0x4FOE, 
TAPI SIM. EFILE USIM PHONEBOOK GASI = Ox4FOF, 


ТАРІ SIM EFILE USIM PHONEBOOK АМК =  Ox4FF4, TAPI SIM EFILE USIM - 
PHONEBOOK SNE = Ox4FF9, ТАРІ SIM EFILE USIM PHONEBOOK EMAIL = Ox4FFA, 
TAPI SIM EFILE USIM PHONEBOOK ANRA = Ox4F13, 


TAPI SIM EFILE USIM PHONEBOOK ANRB = 0х4Е14, ТАРІ SIM EFILE USIM - 
PHONEBOOK ANRC = Ox4F15, TAPI SIM EFILE USIM PHONEBOOK ANRI = Ox4F16, 
TAPI SIM. EFILE USIM PHONEBOOK ANRAI = 0x4F17, 


ТАРІ SIM EFILE USIM PHONEBOOK АМКВІ = Ox4F18, ТАРІ SIM EFILE USIM - 
РНОМЕВООК ANRCI = Ox4F21, ТАРІ SIM EFILE USIM РНОМЕВООК ADNI = Ox4F1A, 
ТАРІ SIM. EFILE USIM PHONEBOOK РВСІ = 0x4F1B, 


TAPI SIM EFILE USIM РНОМЕВООК СЕРІ =  Ox4FIC, ТАРІ SIM EFILE ОІМ - 
РНОМЕВООК SNEI! = Ox4FID, ТАРІ SIM EFILE USIM PHONEBOOK UIDI = Ox4FIE, 
ТАРІ SIM EFILE USIM РНОМЕВООК EMAILI = Ox4F1F, 


TAPI SIM EFILE USIM PHONEBOOK ТАРІ = 0х4ЕЕ5, ТАРІ SIM EFILE TELECOM - 
PHONEBOOK PBR = 0x4F30, TAPI SIM EFILE TELECOM РНОМЕВООК РВКІ = 0x4F29, 
ТАРІ SIM EFILE TELECOM PHONEBOOK РВК2 = 0x4F28, 


ТАРІ SIM EFILE TELECOM PHONEBOOK CCP] =  Ox4F3D, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK UID = Ox4F00, ТАРІ SIM EFILE TELECOM PHONEBOOK PSC 
= Ox4F22, ТАРІ SIM EFILE TELECOM PHONEBOOK CC = 0x4F23, 


ТАРІ SIM EFILE TELECOM PHONEBOOK PUID = 0х4Е24, TAPI SIM EFILE - 
TELECOM PHONEBOOK ADN = 0x4F3A, TAPI SIM EFILE TELECOM PHONEBOOK - 
ТАР = 0х4Е25, TAPI SIM EFILE TELECOM PHONEBOOK PBC = 0x4F09, 


TAPI SIM EFILE TELECOM PHONEBOOK EXTI =  Ox4F4A, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK GRP = 0х4Е26, TAPI SIM EFILE TELECOM PHONEBOOK - 
AAS = 0x4F4B, ТАРІ SIM EFILE TELECOM PHONEBOOK GAS = Ox4F4C, 
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ТАРІ SIM EFILE TELECOM PHONEBOOK АМА =  Ox4Fll, TAPI SIM EFILE - 
TELECOM PHONEBOOK SNE = 0x4F19, ТАРІ SIM EFILE TELECOM PHONEBOOK - 
EMAIL = Ox4F50, ТАРІ SIM EFILE TELECOM PHONEBOOK ANRA = 0x4F31, 


ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB =  Ox4F32, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ANRC = Ox4F40, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
ANRI = Ox4F33, ТАРІ SIM EFILE TELECOM, РНОМЕВООК ANRAI = 0x4F34, 
ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB1 =  Ox4F35, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ADNI = Ox4F36, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
РВСІ = Ox4F37, TAPI SIM EFILE TELECOM. РНОМЕВООК СЕРІ = 0x4F38, 
ТАРІ SIM EFILE TELECOM PHONEBOOK SNEI = Ox4F39, ТАРІ SIM. EFILE - 
TELECOM РНОМЕВООК UID1 = Ox4F3B, ТАРІ SIM EFILE TELECOM. PHONEBOOK - 
EMAIL] = 0x4F3C, ТАРІ SIM EFILE TELECOM, PHONEBOOK ТАРІ = Ox4F3E, 

TAPI SIM EFILE MSG WAITING INDICATION STATUS =  0x6FCA, ТАРІ SIM - 
EFILE INVALID = OxFFFF, ТАРІ SIM EFILE, OTHERS } 

enum TelSimFileType t { 

TAPI SIM FTYPE DEDICATED - 0x00, TAPI SIM FTYPE TRANSPARENT - 0x01, TAPI - 
SIM. FTYPE LINEAR FIXED - 0x02, TAPI SIM FTYPE CYCLIC - 0x04, 

ТАРІ SIM, FTYPE INVALID TYPE = OxFF } 

enum TelSimRecordMode t ( 

TAPI SIM. RECORD NONE = 0x00, TAPI SIM RECORD ABSOLUTE = 0x01, TAPI SIM - 
RECORD. CURRENT = 0x02, TAPI SIM. RECORD NEXT = 0x03, 

TAPI SIM RECORD PREVIOUS = 0x04, TAPI SIM, RECORD TO THE LAST = 0x05, 
TAPI SIM RECORD FROM, THE FIRST - 0x06 } 

enum TelSimPinStatus t { 

TAPI SIM. PIN STATUS DISABLED = 0x00, ТАРІ SIM PIN STATUS ENABLED = 0x01, 
TAPI SIM. PIN STATUS BLOCKED = 0x02, ТАРІ SIM. PIN STATUS РОК BLOCKED = 
0x03, 
ТАРІ SIM PIN STATUS UNKNOWN = OxFF } 

enum TelSimPinOperationResult t { 

TAPI SIM. PIN OPERATION SUCCESS, ТАРІ SIM, BUSY STATUS, ТАРІ SIM. CARD - 
ERROR, STATUS, TAPI SIM, INCOMPATIBLE PIN. OPERATION STATUS, 

TAPI SIM. PIN ІМСОККЕСТ PASSWORD STATUS, TAPI SIM. PIN2 REQD STATUS, 
TAPI SIM. PIN2 INCORRECT PASSWORD STATUS, ТАРІ SIM. РОК INCORRECT - 
PASSWORD STATUS, 

ТАРІ SIM. РОК REQD STATUS, ТАРІ SIM, PUK2 REQD STATUS ) 

enum TelSimAccessResult_t ( 

TAPI SIM. ACCESS. SUCCESS, ТАРІ SIM. ACCESS CARD ERROR, ТАРІ SIM, ACCESS - 
FILE NOT. FOUND, TAPI SIM ACCESS ACCESS CONDITION МОТ SATISFIED, 

TAPI SIM. ACCESS FAILED } 

enum TelSimPinType t { 

TAPI SIM PTYPE РІМІ = 0x00, ТАРІ SIM. PTYPE PIN2 = 0x01, ТАРІ SIM PTYPE РОКІ = 
0x02, ТАРІ SIM. PTYPE РОК2 = 0x03, 

TAPI SIM, PTYPE UPIN = 0x04, TAPI SIM PTYPE ADM = 0x05 } 

enum TelSimTypeOfNum t { 

TAPI SIM TON UNKNOWN = 0, TAPI SIM TON INTERNATIONAL = 1, TAPI SIM TON - 
NATIONAL = 2, ТАРІ SIM, TON. NETWORK, SPECIFIC = 3, 

TAPI SIM TON DEDICATED ACCESS = 4, ТАРІ SIM, TON. ALPHA, NUMERIC = 5, TAPI - 
SIM, TON ABBREVIATED NUMBER = 6, TAPI SIM TON RESERVED FOR EXT 27] 
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enum  TelSimTextEncrypt t { ТАРІ SIM TEXT ЕМС ASCIL ТАРІ SIM TEXT ENC - 
GSM7BIT, ТАРІ SIM TEXT ЕМС UCS2, ТАРІ SIM TEXT ЕМС HEX } 
enum TelSimPbFileType t { 


TAPI SIM PB FDN, TAPI SIM PB LDN, TAPI SIM PB MSISDN, TAPI SIM PB ADN, 


TAPI SIM PB SDN } 

enum TelSimPbAccessMode t { TAPI SIM PB ACCESS MODE ADD = 0x01, TAPI SIM - 
PB ACCESS MODE DEL = 0x02, ТАРІ SIM PB ACCESS МОРЕ EDIT = 0x03 } 

enum TelSimNumberingPlanldentity t { 

TAPI SIM NPI UNKNOWN = 0, TAPI SIM NPI ISDN TEL = 1, TAPI SIM NPI DATA - 
NUMBERING PLAN = 3, ТАРІ SIM NPI TELEX = 4, 

TAPI SIM NPI SVC CNTR SPECIFIC PLAN - 5, TAPI SIM NPI SVC CNTR SPECIFIC - 
PLAN? = 6, ТАРІ SIM NPI NATIONAL = 8, ТАРІ SIM NPI PRIVATE = 9, 

TAPI SIM NPI ERMES NUMBERING PLAN = 10, TAPI SIM NPI RESERVED FOR EXT 
= OxF } 

enum TelSimEccEmergencyServiceInfo t { 

TAPI SIM ECC ESC POLICE = 0x01, TAPI SIM ECC ESC AMBULANCE = 0x02, TAPI - 
SIM. ECC ESC FIREBRIGADE = 0x03, ТАРІ SIM ECC Е5С MARAINEGUARD = 0x04, 
ТАРІ SIM ECC ESC MOUTAINRESCUE = 0x05, ТАРІ SIM ECC ESC SPARE = 0x00 } 
enum TelSimPbAccessResult. t ( 


TAPI SIM PB SUCCESS, TAPI SIM PB FAIL, TAPI SIM PB INVALID INDEX, TAPI - 
SIM PB INVALID NUMBER LENGTH, 


TAPI SIM. PB. INVALID NAME LENGTH, ТАРІ SIM PB ACCESS CONDITION. NOT - 
SATISFIED } 

enum TelSimLanglIndicationCode t { 

TAPI SIM LI GERMAN = О, TAPI SIM LI ENGLISH = 0x01, TAPI SIM LI ITALIAN = 
0x02, TAPI SIM. LI FRENCH = 0x03, 

ТАРІ SIM. LI SPANISH = 0x04, ТАРІ SIM LI DUTCH = 0x05, ТАРІ SIM. LI SWEDISH = 
0x06, TAPI SIM. LI DANISH - 0x07, 

TAPI SIM LI PORTUGUESE = 0x08, TAPI SIM LI FINNISH = 0x09, TAPI SIM LI - 
NORWEGIAN = 0x0A, ТАРІ SIM 11 GREEK = OxOB, 

ТАРІ SIM LI TURKISH = 0xOC, ТАРІ SIM, LI HUNGARIAN = O0xOD, ТАРІ SIM LI - 
POLISH = OxOE, ТАРІ SIM LI LANG UNSPECIFIED = OxOF } 

enum TelSimAccessType t { 

TAPI SIM SELECT, TAPI SIM READ BINARY, TAPI SIM READ RECORD, TAPI SIM - 
СЕТ RESPONSE, 

TAPI SIM. UPDATE BINARY, ТАРІ SIM, UPDATE RECORD, ТАРІ SIM, STATUS } 

enum TelSimCardStatus t { 

TAPI SIM. STATUS CARD ERROR = 0x00, TAPI SIM, STATUS CARD NOT PRESENT = 


0x01, ТАРІ SIM STATUS SIM INITIALIZING = 0x02, ТАРІ SIM. STATUS SIM INIT - 
COMPLETED = 0x03, 


TAPI SIM, STATUS SIM PIN REQUIRED = 0x04, TAPI SIM, STATUS SIM PUK - 
REQUIRED = 0x05, ТАРІ SIM STATUS CARD BLOCKED = 0x06 } 

enum TelSimAcl t { 

TAPI SIM, АСІ, ALW = 0x00, ТАРІ SIM, ACL РІМІ = 0x01, ТАРІ SIM, ACL PIN2 = 0x02, 
TAPI SIM, ACL КЕС = 0x04, 


TAPI SIM ACL ADM = 0x08, TAPI SIM ACL NEVER = OxFF } 
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5.94.1 Define Documentation 


5.94.1.1 #define ТАРІ SIM ACL MAX LEN 50 


Maximum ACL length 


5.94.1.2 #define ТАРІ SIM ECC ALPHA STRING LEN MAX 50 


Maximum ECC Alpha string length 


5.94.1.3 ffdefine ТАРІ SIM ECC CODE ТЕМ З 


Maximum ECC code length 


5.94.1.4 #define ТАРІ SIM ECC MAX LEN 15 


Maximum ECC length 


5.94.1.5 #define ТАРІ SIM GROUP IDENTIFIER LEN MAX 10 


Maximum group identifier length 


5.94.1.6 #define ТАРІ SIM GSM SST SERVICE MAX COUNT 50 


Maximum SST service count 


5.94.1.7 #define ТАРІ SIM ICCID MAX LEN 10 


Maximum length of ICCID 


5.94.1.8 #define ТАРІ SIM ICCID PACKET LEN 10 


ICCID Packet Length 


5.94.1.9 #define ТАРІ SIM ICCIDLENGTH 10 


ICCID Length 


5.94.1.10 define ТАРІ SIM IMSI LEN 8 


IMSI length 


5.94.1.11 #ебпе ТАРІ SIM IMSI PACKET LEN 15 


maximum IMSI packet length 
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5.94.1.12 #ебпе ТАРІ SIM LI MAX LEN 30 


Maximum Language indication length 


5.94.1.13 #ебпе ТАРІ SIM LI PACKET MAX LEN 30 


maximum LI Packet length 


5.94.1.14 #ебпе ТАРІ SIM LP MAX LEN 30 


Language preference maximum length 


5.94.1.15 ffdefine ТАРІ SIM LP PACKET MAX LEN 30 


Language preference packet maximum length 


5.94.1.16 #define ТАРІ SIM MCC CODE ТЕМ З 


maximum MCC code length 


5.94.1.17 #ебпе ТАРІ SIM ММС CODE LEN 2 


maximum MNC Code length 


5.94.1.18 #ебпе ТАРІ SIM MSIN CODE LEN 10 


Maximum MSIN code length 


5.94.1.19 #ебпе ТАРІ SIM NUM TEXT MAX LEN 256 


Maximum Text length for number 


5.94.1.20 #ебпе ТАРІ SIM PIN LENGTH 8 


max length for PIN 


5.94.1.21 #define ТАРІ SIM SST MAX LEN 20 


Maximum SST code length 


5.94.1.22 #define ТАРІ SIM UECC RECORD COUNT МАХ 5 


Maximum UECC Record count 
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5.94.1.23 #define ТАРІ SIM UECC RECORD LEN MAX 50 


Maximum UECC record length 


5.94.1.24 #ебпе ТАРІ ТАРІ SIM PBOOK ENTRY COUNT МАХ 20 


max 254 entries within a record of PBR 


5.94.2 Enumeration Type Documentation 
5.04.2.1 enum TelSimAccessResult t 


This enumeration defines the SIM access result from the lower layers. 


Enumerator: 


TAPI SIM ACCESS SUCCESS Access to file successful. 
TAPI SIM ACCESS CARD ERROR Sim card error 
TAPI SIM ACCESS FILE NOT FOUND File not found 


TAPI SIM ACCESS ACCESS CONDITION NOT SATISFIED Access condition is not ful- 
filled 


TAPI SIM ACCESS FAILED Access failed. 


5.94.2.2 enum TelSimAccessType t 


This enumeration defines the access type information. 


Enumerator: 


TAPI SIM SELECT Select SIM 

TAPI SIM READ BINARY Read binary file 
TAPI SIM READ RECORD Read record 
TAPI SIM GET RESPONSE Get response 
TAPI SIM UPDATE BINARY Update binary 
TAPI SIM UPDATE RECORD Update record 
TAPI SIM STATUS SIM status 


5.94.2.3 enum TelSimAcl t 


This enumeration defines the ACL. 
Enumerator: 


ТАРІ SIM ACL ALW ALWays 

TAPI SIM ACL PINI PIN 1 

TAPI SIM ACL PIN2 PIN2 
TAPI SIM ACL RFU RFU 

TAPI SIM ACL ADM Administration Key 
TAPI SIM ACL NEVER Never 
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5.94.2.4 enum TelSimCardStatus t 


This enumeration defines the SIM card status 


Enumerator: 
TAPI SIM STATUS CARD ERROR Bad card / On the fly SIM gone bad 
TAPI SIM STATUS CARD NOT PRESENT Card not present / removed 
TAPI SIM STATUS SIM INITIALIZING Sim is Initializing state 
TAPI SIM STATUS SIM INIT COMPLETED Sim Initialization ok 
TAPI SIM STATUS SIM PIN REQUIRED PIN required state 
TAPI SIM STATUS SIM PUK REQUIRED  PUK required state 


TAPI SIM STATUS CARD BLOCKED  PIN/PUK blocked(permanently blocked- АП the at- 
tempts for PIN/PUK failed) 


5.04.2.5 enum TelSimCardType t 
This enumeration defines the card type. 


Enumerator: 
TAPI SIM CARD TYPE UNKNOWN Unkown card 
TAPI SIM CARD TYPE GSM Gsm card 
TAPI SIM CARD TYPE USIM Usim card 


5.94.2.6 enum TelSimEccEmergencyServiceInfo t 
This enumeration defines the emergency service type. 


Enumerator: 
TAPI SIM ECC ESC POLICE Police 
TAPI SIM ECC ESC AMBULANCE Ambulance 
TAPI SIM ECC ESC FIREBRIGADE Fire brigade 
TAPI SIM ECC ESC MARAINEGUARD Marine guard 
TAPI SIM ECC ESC MOUTAINRESCUE Mountain rescue 
TAPI SIM ECC ESC SPARE Spare 


5.94.2.7 enum TelSimFileName t 


This enumeration defines the file id. 


Enumerator: 
TAPI_SIM_EFILE_DIR for the USIM 
TAPI SIM EFILE ICCID the ICC Identification file 
ТАРІ SIM EFILE АРМ the Abbrv. Dialing Num file 
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TAPI SIM EFILE FDN the Fixed Dialing Num file 

ТАРІ SIM EFILE SMS the Short Messages file 

TAPI SIM EFILE CCP the Capab. Config Param file 

ТАРІ SIM EFILE IMSI the IMSI file 

TAPI SIM EFILE SST the SIM Service Table file 

TAPI SIM EFILE EST the Extended Service Table File 
TAPI SIM EFILE ACM the Accumul. Call Meter file 

TAPI SIM EFILE MBDN SIM Mail Box Dailing Number file 
ТАРІ SIM EFILE GIDI the Group Identifier Level 1 

TAPI SIM EFILE GID2 the Group Identifier Level 2 

TAPI SIM EFILE MSISDN the MSISDN file 

TAPI SIM EFILE SMSP the Short Msg Srv. Param file 
TAPI SIM EFILE SMSS the SMS Status 

TAPI SIM EFILE EXTI the Extension 1 file 

TAPI SIM EFILE EXT2 the Extension 2 file 

TAPI SIM EFILE LP the Language Preference file 

TAPI SIM EFILE ACM MAX the ACM maximum value file 
TAPI SIM EFILE PUCT the Price per Unit and. file 

TAPI SIM EFILE CBMI the Cell Brd msg Id sel file 

TAPI SIM EFILE PHASE the PHASE identification file 
TAPI SIM EFILE SDN the Service Dialing Numbers 

TAPI SIM EFILE ЕХТЗ the Extension 3 file 

TAPI SIM EFILE BDN the BDN file 

ТАРІ SIM EFILE EXT4 the Extension 4 file 

TAPI SIM EFILE ECC the Emergency Call Codes 

TAPI SIM EFILE SPN the Service Provider Name 

TAPI SIM EFILE PNN the Service Provider Name 

TAPI SIM EFILE IMG image 

TAPI SIM EFILE USIM LI Language Indication 

TAPI SIM EFILE USIM IMSI IMSI 

TAPI SIM EFILE USIM ACM MAX АСМ maximum value 
TAPI SIM EFILE USIM UST USIM Service Table 

TAPI SIM EFILE USIM ACM Accumulated Call Meter 
TAPI SIM EFILE USIM SPN Service Provider Name 

TAPI SIM EFILE USIM PUCT Price per Unit and Currency Table 
TAPI SIM EFILE USIM CBMI Cell Broadcaster Message Identifier selection 
TAPI SIM EFILE USIM ECC Emergency Call Codes 

TAPI SIM EFILE USIM FDN Fixed Dialing Number 

TAPI SIM EFILE USIM SMS USIM SMS 

TAPI SIM EFILE USIM MSISDN USIM MSISDN 

TAPI SIM EFILE USIM SMSP USIM SMSP 
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TAPI SIM EFILE 


USIM SMSS USIM SMSS 


TAPI SIM EFILE 


USIM SDN USIM SDN 


TAPI SIM EFILE 


USIM ЕХТІ USIM EXTI 


TAPI SIM EFILE 


USIM EXT2 USIM EXT2 


TAPI SIM EFILE 


USIM EXT3 USIM EXT3 


TAPI SIM EFILE 


USIM ЕХТ4 USIM EXTA 


TAPI SIM EFILE 


USIM EXTS5 Extension 5 


TAPI SIM EFILE 


USIM CCP2 Capability Configuration Parameters 2 


TAPI SIM EFILE 


USIM HIDDEN KEY Key for hidden phonebook entries 


TAPI SIM EFILE 


USIM BDN Barred Dialing Numbers 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM MBDN USIM Mail box dialing number 
USIM MBI Mailbox Identifier 


TAPI SIM EFILE 


USIM PHONEBOOK PBR Phonebook Reference File 


TAPI SIM EFILE 


USIM PHONEBOOK CCPI Capability Configuration Parameters 1 


TAPI SIM EFILE 


USIM PHONEBOOK UID unique identifier 


TAPI SIM EFILE 


USIM PHONEBOOK PSC phonebook synchronization counter 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PHONEBOOK CC change counter 
USIM PHONEBOOK PUID previous unique identifier 


TAPI SIM EFILE 


USIM PHONEBOOK ADN Abbreviated Dialing Number 


TAPI SIM EFILE 


USIM PHONEBOOK IAP Index Administration Phonebook 


TAPI SIM EFILE 


USIM PHONEBOOK PBC Phonebook Control 


TAPI SIM EFILE 


USIM PHONEBOOK EXTI Extension 1 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PHONEBOOK GRP Grouping File 
USIM PHONEBOOK AAS Additional number Alpha String 


TAPI SIM EFILE 


USIM PHONEBOOK AASI Additional number Alpha String 


TAPI SIM EFILE 


USIM PHONEBOOK GAS Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK GASI Second Name Entry 


TAPI SIM EFILE 


USIM PHONEBOOK АМК Additional Number 


TAPI SIM EFILE 


TAPI SIM EFILE 


USIM PHONEBOOK SNE Second Name Entry 
USIM PHONEBOOK EMAIL e-mail address 


TAPI SIM EFILE 


USIM PHONEBOOK ANRA Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRB Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRC Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRAI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRBI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ANRCI Additional Number 


TAPI SIM EFILE 


USIM PHONEBOOK ADNI  Abbreviated Dialing Number 


TAPI SIM EFILE 


USIM PHONEBOOK РВСІ Phonebook Control 


TAPI SIM EFILE 


USIM PHONEBOOK СЕРІ Grouping File 


TAPI SIM EFILE 


USIM PHONEBOOK SNEI Second Name Entry 
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TAPI SIM EFILE USIM PHONEBOOK UIDI unique identifier 

ТАРІ SIM EFILE USIM PHONEBOOK EMAILI e-mail address 

ТАРІ SIM EFILE USIM PHONEBOOK IAPI Index Administration Phonebook 
TAPI SIM EFILE TELECOM PHONEBOOK PBR  Phonebook Reference File 

TAPI SIM EFILE TELECOM PHONEBOOK PBRI Phonebook Reference File 1 
TAPI SIM EFILE TELECOM PHONEBOOK PBR2 Phonebook Reference File 1 
TAPI SIM EFILE TELECOM PHONEBOOK CCPI Capability Configuration Parameters 1 
ТАРІ SIM EFILE TELECOM PHONEBOOK UID unique identifier 

TAPI SIM EFILE TELECOM PHONEBOOK PSC  Phonebook synchronization counter 
TAPI SIM EFILE TELECOM PHONEBOOK CC change counter 

TAPI SIM EFILE TELECOM PHONEBOOK PUID previous unique identifier 
TAPI SIM EFILE TELECOM PHONEBOOK ADN Abbreviated Dialing Number 
TAPI SIM EFILE TELECOM PHONEBOOK ТАР Index Administration Phonebook 
TAPI SIM EFILE TELECOM PHONEBOOK PBC Phonebook Control 

TAPI SIM EFILE TELECOM PHONEBOOK EXTI Extension 1 

TAPI SIM EFILE TELECOM PHONEBOOK GRP Grouping File 

TAPI SIM EFILE TELECOM PHONEBOOK AAS Additional number Alpha String 
TAPI SIM EFILE TELECOM PHONEBOOK GAS Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANR Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK SNE Second Name Entry 

TAPI SIM EFILE TELECOM PHONEBOOK EMAIL e-mail address 

TAPI SIM EFILE TELECOM PHONEBOOK ANRA Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRB Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRC Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRI Additional Number 

ТАРІ SIM EFILE TELECOM PHONEBOOK ANRAI Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ANRBI Additional Number 

TAPI SIM EFILE TELECOM PHONEBOOK ADNI  Abbreviated Dilling Number 
TAPI SIM EFILE TELECOM PHONEBOOK PBCI Phonebook Control 

TAPI SIM EFILE TELECOM PHONEBOOK СЕРІ Grouping File 

TAPI SIM EFILE TELECOM PHONEBOOK SNEI Second Name Entry 

TAPI SIM EFILE TELECOM PHONEBOOK UIDI unique identifier 

ТАРІ SIM EFILE TELECOM PHONEBOOK EMAILI e-mail address 

TAPI SIM EFILE TELECOM PHONEBOOK ТАРІ Index Administration Phonebook 


TAPI SIM EFILE INVALID Elements enumerating (known) Elementary files in SIM like EF- 
DIR, EF-VGCS, EF-VBS, EF-PBR, EF-ADN, EF-IAP, EF-EXTI, EF-SNE, EF-ANR, EF-PBC, 
EF-GRP, EF-AAS, EF-GAS, EF-UID, EF-EMAIL, EF-CCP1, EF-PSC, EF-CC, EF-PUID, EF- 
FDN etc. 


TAPI SIM EFILE OTHERS Element to indicate an unknown file. 
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5.04.2.8 enum TelSimFileType t 
This enumeration defines the file type. 


Enumerator: 


TAPI SIM FTYPE DEDICATED Dedicated 
TAPI SIM FTYPE TRANSPARENT Transparent 
TAPI SIM FTYPE LINEAR FIXED Linear fixed 
TAPI SIM FTYPE CYCLIC Cyclic 

TAPI SIM FTYPE INVALID TYPE Invalid type 


5.94.2.9 enum TelSimLanglIndicationCode t 


This enumeration defines the language indication code. 


Enumerator: 


TAPI SIM LI GERMAN German 

TAPI SIM LI ENGLISH English 

ТАРІ SIM LI ITALIAN Italian 

TAPI SIM LI FRENCH French 

TAPI SIM LI SPANISH Spanish 

TAPI SIM LI DUTCH Dutch 

TAPI SIM LI SWEDISH Swedish 

TAPI SIM LI DANISH Danish 

TAPI SIM LI PORTUGUESE Portuguese 
TAPI SIM LI FINNISH Finnish 

TAPI SIM LI NORWEGIAN Norwegian 
TAPI SIM LI GREEK Greek 
TAPI SIM LI TURKISH Turkish 

TAPI SIM LI HUNGARIAN Hungarian 
TAPI SIM LI POLISH Posish 

TAPI SIM LI LANG UNSPECIFIED  Unspecified 


5.94.2.10 enum TelSimNumberingPlanldentity t 
This enumeration defines the numbering plan identifier. 


Enumerator: 


TAPI SIM NPI UNKNOWN Unknown 

ТАРІ SIM NPI ISDN TEL ISDN/Telephone numbering plan 

TAPI SIM NPI DATA NUMBERING PLAN Data numbering plan 
TAPI SIM NPI TELEX Telex numbering plan 

TAPI SIM NPI SVC CNTR SPECIFIC PLAN Service Center Specific plan 
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ТАРІ SIM NPI SVC CNTR SPECIFIC PLAN2 Service Center Specific plan 
TAPI SIM NPI NATIONAL National numbering plan 

TAPI SIM NPI PRIVATE Private numbering plan 

TAPI SIM NPI ERMES NUMBERING PLAN ERMES numbering plan 
TAPI SIM NPI RESERVED FOR EXT Reserved for extension 


5.94.2.11 enum TelSimPbAccessMode t 
This enumeration defines modes to add,del,edit for phone book access 


Enumerator: 
TAPI SIM PB ACCESS MODE ADD Phone Book Access mode - Add entry 
TAPI SIM PB ACCESS MODE DEL Phone Book Access mode - Delete entry 
TAPI SIM PB ACCESS MODE EDIT Phone Book Access mode - edit entry 


5.94.2.12 enum TelSimPbAccessResult t 
This enumeration defines the Phone book access result 


Enumerator: 
TAPI SIM PB SUCCESS SIM phonebook operation successful. 
TAPI SIM PB FAIL SIM phonebook operation failure. 
TAPI SIM PB INVALID INDEX The index passed was not a valid index. 


TAPI SIM PB INVALID NUMBER LENGTH The number length is exceecds the max length 
allowed (or 0). 


TAPI SIM PB INVALID NAME LENGTH The name length is exceecds the max length allowed 
(or 0). 


ТАРІ SIM PB ACCESS CONDITION NOT SATISFIED Access condition for PB file is not 
satisfied. 


5.94.2.13 enum TelSimPbFileType t 
This enumeration defines different storage types to be selected in SIM or USIM 


Enumerator: 
TAPI SIM PB FDN sim FDN 
TAPI SIM PB LDN sim last dialled num 
TAPI SIM PB MSISDN sim my own number - MSISDN list 
TAPI SIM PB ADN SIM- ADN 
ТАРІ SIM PB SDN Sim service dialing num 
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5.94.2.14 enum TelSimPinOperationResult t 
This enumeration defines the pin operation result from the lower layers. 


Enumerator: 


TAPI SIM PIN OPERATION SUCCESS Operation involving PIN (verifica- 
tion/change/enable/disable, etc) is successful. 


ТАРІ SIM BUSY STATUS 5ітп 15 busy 
TAPI SIM CARD ERROR STATUS Sim card error 


TAPI SIM INCOMPATIBLE PIN OPERATION STATUS Sim Incompatible pin operation that 
is in case when invalid SIM command is given or incorrect parameters are supplied to the SIM. 


TAPI SIM PIN INCORRECT PASSWORD STATUS Sim PIN Incorrect password 
ТАРІ SIM PIN2 REQD STATUS Sim PIN2 Required Status 

ТАРІ SIM PIN2 INCORRECT PASSWORD STATUS Sim PIN? Incorrect password 
TAPI SIM PUK INCORRECT PASSWORD STATUS Sim PUK Incorrect Password 
TAPI SIM PUK REQD STATUS РОК Required 

ТАРІ SIM PUK2 REQD STATUS PUK2 Required 


5.94.2.15 enum TelSimPinStatus t 
This enumeration defines the pin status. 


Enumerator: 
TAPI SIM PIN STATUS DISABLED PIN status Disabled 
TAPI SIM PIN STATUS ENABLED PIN status Enabled 


TAPI SIM PIN STATUS BLOCKED SIM is present, but PIN is blocked. Need unblocking by 
PUK 


TAPI SIM PIN STATUS PUK BLOCKED SIM is present, but PUK is blocked 
TAPI SIM PIN STATUS UNKNOWN SIM is in unknown state 


5.94.2.16 enum TelSimPinType t 
This enumeration defines the pin type. 


Enumerator: 
TAPI SIM PTYPE PINI РІМІ 
ТАРІ SIM PTYPE PIN2 PIN2 
TAPI SIM PTYPE PUKI Puk! 
TAPI SIM PTYPE PUK2 Puk2 
TAPI SIM PTYPE UPIN Universal PIN 
TAPI SIM PTYPE ADM Administrator 
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5.94.2.17 enum TelSimRecordMode t 


This enumeration defines the record mode. 


Enumerator: 
TAPI SIM RECORD NONE N/A, meaning the target file isn't a record type 
TAPI SIM RECORD ABSOLUTE The specified record will be read or updated 
TAPI SIM RECORD CURRENT The current record will be read or updated 
TAPI SIM RECORD NEXT The next record will be read or updated 
TAPI SIM RECORD PREVIOUS The previous record will be read or updated 


TAPI SIM RECORD TO THE LAST АП records from the record specified by record index to 
the last one will be read to the last 


TAPI SIM RECORD FROM THE FIRST All records from the first record to the one specified 
by record, index will be read from the first 


5.94.2.18 enum TelSimTextEncrypt t 
This enumertion defines the text encryption types 


Enumerator: 
TAPI SIM TEXT ENC ASCII ASCII Encoding 
ТАРІ SIM TEXT ЕМС GSM7BIT GSM 7 Bit Encoding 
TAPI SIM TEXT ENC UCS2 UCS2 Encoding 
TAPI SIM TEXT ENC HEX HEX Encoding 


5.04.2.19 enum TelSimTypeOfNum t 
This enumeration defines the type of number. 


Enumerator: 


ТАРІ SIM TON UNKNOWN unknown 

TAPI SIM TON INTERNATIONAL international number 

TAPI SIM TON NATIONAL national number 

TAPI SIM TON NETWORK SPECIFIC network specific number 

TAPI SIM TON DEDICATED ACCESS subscriber number 

TAPI SIM TON ALPHA NUMERIC alphanumeric, GSM 7-bit default alphabet) 
TAPI SIM TON ABBREVIATED NUMBER abbreviated number 

TAPI SIM TON RESERVED FOR EXT reserved for extension 
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5.95 SS DataStructures 


Files 


file TelSs.h 


This file serves as a "C" header file defines structures for Tapi SS Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelSsForwardInfo t 

struct TelSsUssdMsglInfo t 
struct TelSsCallBarringInfo t 
struct TelSsCliRecord t 

struct TelSsCallBarringRecord t 
struct TelSsForwardRecord. t 
struct TelSsCallWaitingRecord t 
union TelSsRecord t 

struct TelSsInfo t 

struct TelSsCapabilityInfo t 


Defines 


#define ТАРІ 55 GSM BARR PW LEN MAX 4 
#define ТАРІ CALL. DIALDIGIT LEN MAX 82 
fdefine TAPI SS USSD DATA SIZE MAX 201 


Enumerations 


enum TelSsForwardWhen t { 


TAPI SS FORWARD WHEN UNCONDITIONAL EV, TAPI SS FORWARD WHEN - 
BUSY EV, TAPI SS FORWARD WHEN NO ANSWER EV, TAPI SS FORWARD WHEN - 
NOT REACHABLE EV, 

TAPI SS FORWARD WHEN ALL FORWARDING EV } 

enum TelSsCallBarType t { 


TAPI CALL BARRING ALL, TAPI CALL ВАККІМС OUTGOING, TAPI CALL - 


ВАККІМС ALL OUTGOING. CALLS, TAPI CALL BARRING ALL OUTGOING - 
INTERN CALL, 
TAPI CALL BARRING ALL OUTGOING INTERN CALL EXCEPT, TAPI CALL - 


BARRING INCOMING, TAPI CALL BARRING ALL INCOMING CALLS, TAPI CALL - 
BARRING АШ, INCOMING CALLS  ROAMING, 

ТАРІ CALL BARRING. ALL INCOMING. CALLS INSIM } 

enum TelSsTeleService t { 

ТАРІ SS TS ALL ТЕГЕ AND BEARER SERVICES, ТАРІ SS TS ALL TELESERVICES, 
ТАРІ SS TS АШ, SPEECH, ТАРІ SS TS ALL DATA TELESERVICES, 


TAPI SS TS FACS, ТАРІ SS TS ALL TELESERVICES EXCEPT SMS,  TAPI SS TS - 
ALL PLMN SPEC TELE, TAPI SS TS PLMN SPEC TELE 1, 
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ТАРІ SS TS PLMN SPEC TELE 2, ТАРІ SS TS PLMN SPEC TELE 3, ТАРІ SS TS - 
PLMN SPEC TELE 4, TAPI SS TS PLMN SPEC TELE 5, 

TAPI SS TS PLMN SPEC TELE 6, TAPI SS TS PLMN SPEC TELE 7, TAPI SS TS - 
PLMN SPEC TELE 8, TAPI SS TS PLMN SPEC TELE 9, 

TAPI SS TS PLMN SPEC TELE A, TAPI SS TS PLMN SPEC TELE B, TAPI SS TS - 
PLMN SPEC TELE C, TAPI SS TS PLMN SPEC TELE D, 

TAPI SS TS PLMN SPEC TELE E, TAPI SS TS PLMN SPEC TELE F, TAPI SS TS - 
PLMN SPEC TELE , TAPI SS BS ALL BEARER SERVICES, 

TAPI SS BS ALL DATA CDS, TAPI SS В5 ALL ASYNCHRONOUS, TAPI SS BS ALL - 
SYNCHRONOUS, TAPI SS BS DATA CIRCUIT SYNC, 

TAPI SS BS DATA CIRCUIT ASYNC, TAPI SS BS DATA ALL PDS, TAPI SS BS ALL - 
DATA. PADCA, ТАРІ SS BS ALL PLMN SPEC BS, 

TAPI SS BS PLMN SPEC TELE 1, TAPI SS BS PLMN SPEC TELE 2, TAPI SS BS - 
PLMN SPEC TELE 3, TAPI SS BS PLMN SPEC TELE 4, 

TAPI SS BS PLMN SPEC TELE 5, TAPI SS BS PLMN SPEC TELE 6, TAPI SS BS - 
PLMN SPEC TELE 7, TAPI SS BS PLMN SPEC TELE 8, 

TAPI SS BS PLMN SPEC TELE 9, TAPI SS BS PLMN SPEC TELE A, TAPI SS BS - 
PLMN SPEC TELE B, TAPI SS BS PLMN SPEC TELE C, 

TAPI SS BS PLMN SPEC TELE D, TAPI SS BS PLMN SPEC TELE E, TAPI SS BS - 
PLMN SPEC TELE F, TAPI SS TS ALL DATA, 

TAPI SS TS DATA CIRCUIT SYNC, TAPI SS TS MULTIPLE, TAPI SS TS TELEPHONY, 
TAPI SS TS DATA CIRCUIT ASYNC, 

TAPI SS TS DATA PACKET } 

enum TelSsUssdRespType t { TAPI USSD RES UNKNOWN ALPHABET, TAPI USSD - 
RES DISPL BUSY, ТАРІ USSD RES OK, ТАРІ USSD RES NONE } 

enum TelSsUssdIndType t ( 

ТАРІ USSD IND NOTIFY = 0x00, ТАРІ USSD IND NO ACTION REQUIRE = 0x01, ТАРІ - 
USSD IND. ACTION REQUIRE = 0x02, ТАРІ USSD IND TERMINATED BY NET = 0x03, 
ТАРІ USSD IND OTHER CLIENT = 0x04, ТАРІ USSD IND МОТ SUPPORT = 0x05, ТАРІ - 
USSD IND TIME OUT - 0x06 ] 

enum TelSsCallBarOperationMode t { TAPI SS CALL BAR ACTIVATE, TAPI SS CALL - 
ВАК DEACTIVATE } 

enum TelSsCallType t { 

TAPI CALL TYPE VOICE EV, TAPI CALL TYPE DATA EV, TAPI CALL TYPE FAX - 
EV, TAPI CALL TYPE SHORT MESS EV, 

ТАРІ CALL ТҮРЕ DATA CIRCUIT SYNC ЕУ) 

enum TelSsForwardMode t ( TAPI CALL FORWARD MODE DISABLE EV, TAPI CALL - 
FORWARD MODE ENABLE EV,  TAPI CALL FORWARD MODE REGISTRATION EV, 
TAPI CALL FORWARD MODE ERASURE EV } 

enum TelSsForwardType t { ТАРІ CS FORWARD ТҮРЕ VOICE EV = 0, ТАРІ CS - 
FORWARD TYPE DATA EV, ТАРІ CS FORWARD TYPE FAX ЕУ) 


enum  TelSsRestrictIDStatus t { ТАРІ CALL RESTRICT ID DEPEND NETWORK EV, 
ТАРІ CALL RESTRICT ID ENABLE EV, ТАРІ CALL RESTRICT ID DISABLE ЕУ) 


enum TelSsType t { 


TAPI 55 TYPE BARRING, TAPI 55 TYPE FORWARDING, ТАРІ 55 TYPE WAITING, 
TAPI SS TYPE IDENTIFICATION, 


ТАРІ SS TYPE СМАР, ТҮРЕ SS TYPE USSD } 
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enum TelSsCause t ( 


TAPI SS SUCCESS, TAPI SS TIMEREXPIRE, TAPI SS UNKNOWNSUBSCRIBER, TAPI - 
55 SERVICENOTPROVISIONED, 


TAPI SS CALLBARRED, TAPI SS ILLEGALSSOPERATION ERROR, TAPI SS - 
NOTAVAILABLE, ТАРІ 55 SUBSCRIPTIONVIOLATION, 


TAPI SS FACILITYNOTSUPPORTED, TAPI SS UNEXPECTEDDATAVALUE, ТАРІ SS - 
PWREGISTRATIONFAILURE, ТАРІ 55 NEGATIVEPWCHECK, 


TAPI SS NUMBEROFPWATTEMPTSVIOLATION, TAPI SS UNKNOWNALPHABET, 
ТАРІ 55 USSDBUSY, ТАРІ 55 REJECTEDB YUSER, 


ТАРІ 55 REJECTEDBYNETWORK, ТАРІ SS INVALIDDEFLECTEDTONUMBER, ТАРІ - 
SS MAXNOMPTYEXCEEDED, TAPI SS RESOURCESNOTAVAILABLE, 


TAPI SS UNKNOWNERROR, TAPI SS OEM NOT SUPPORTED } 


enum TelSsStatus t ( 


TAPI SS STATUS ACTIVE, TAPI SS STATUS REGISTERED, TAPI SS STATUS - 
PROVISIONED, TAPI SS STATUS QUIESCENT, 


TAPI SS STATUS NOTHING } 
enum TelSsLineldentificationType_t { 


ТАРІ CALLING LINE IDENTITY PRESENTATION, TAPI_CALLING_LINE_IDENTITY_- 


RESTRICTION, TAPI CONNECTED LINE IDENTITY PRESENTATION, TAPI - 
CONNECTED LINE IDENTITY RESTRICTION, 

TAPI CALLED LINE IDENTITY PRESENTATION, ТАРІ CALLING. NAME - 
PRESENTATION } 


enum TelSsCliStatus, t { 


TAPI CLI STATUS NOT PROVISONED, TAPI CLI STATUS PROVISIONED, TAPI CLI - 
STATUS ACTIVATED, TAPI CLI STATUS UNKOWN, 
TAPI CLI STATUS TEMP RESTRICTED, TAPI CLI STATUS TEMP ALLOWED ] 


enum TelSsBarPwdType t { TAPI SS ВАК GET PWD, TAPI SS BAR NEW PWD, TAPI - 
SS BAR VERIFY NEW PWD } 


5.95.1 Define Documentation 
5.95.1.1 #define ТАРІ CALL DIALDIGIT LEN MAX 82 


maximum length of dial digit 


5.95.1.2 #define ТАРІ SS СМ BARR PW LEN МАХ 4 


maximum length of barring password 


5.95.1.3 #define ТАРІ SS USSD DATA SIZE MAX 201 


User-to-user data maximum size 
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5.95.2 Enumeration Type Documentation 
5.95.2.1 enum TelSsBarPwdType t 
This enumeration defines the Bar password type. 


Enumerator: 
TAPI SS BAR GET PWD This password type indicates already set barring password 
TAPI SS BAR NEW PWD This password type indicates new password 
TAPI SS BAR VERIFY NEW PWD This password type indicates verifying new password 


5.95.2.) enum TelSsCallBarOperationMode t 
This enumeration defines the call barring operation mode . 


Enumerator: 


TAPI SS CALL BAR ACTIVATE Activate call barring 
TAPI SS CALL BAR DEACTIVATE De Activate call barring 


5.95.2.3 enum TelSsCallBarType t 


The various types of call barring. Note, only one type of incoming barring and only one type of outgoing 
barring may be active at any time. 


Enumerator: 


TAPI CALL BARRING ALL Barring all outgoing and incoming calls 
ТАРІ CALL BARRING OUTGOING Barring outgoing call 
TAPI CALL BARRING ALL OUTGOING CALLS Barring all outgoing calls 


TAPI CALL BARRING ALL OUTGOING INTERN CALL Barring all outgoing international 
calls 


TAPI CALL BARRING ALL OUTGOING INTERN CALL EXCEPT Barring all interna- 
tional outgoing 


TAPI CALL BARRING INCOMING  Barring the incoming call 
TAPI CALL BARRING ALL INCOMING CALLS  Barring all incoming calls 


TAPI CALL BARRING ALL INCOMING CALLS ROAMING Barring all incoming calls 
while roaming 


ТАРІ CALL BARRING ALL INCOMING CALLS INSIM Barring Incoming Calls from num- 
bers which is not stored in the SIM memory 


5.95.2.4 enum TelSsCallType t 


This enumeration defines the call type . 


Enumerator: 


TAPI CALL TYPE VOICE EV Voice Call 
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TAPI CALL TYPE DATA EV Data Call 

ТАРІ CALL TYPE FAX EV Fax Call 

TAPI CALL TYPE SHORT MESS EV Short Message 

TAPI CALL TYPE DATA CIRCUIT SYNC EV Data Circuit Sync 


5.95.2.5 enum TelSsCause t 
Describes whether a supplementary service request was a success or a failure; and if it failed, why. 


Enumerator: 


TAPI SS SUCCESS SS operation was successful 

TAPI SS TIMEREXPIRE SS operation timer expired on network. 

TAPI SS UNKNOWNSUBSCRIBER SS error indicating unknown/illegal subscriber. 

TAPI SS SERVICENOTPROVISIONED SS service not provisioned 

TAPI SS CALLBARRED SS operation barred. 

TAPI SS ILLEGALSSOPERATION ERROR Illegal SS operation 

ТАРІ SS NOTAVAILABLE 55 not available in network 

TAPI SS SUBSCRIPTIONVIOLATION SS service subscription violation. 

TAPI SS FACILITYNOTSUPPORTED SS service facility not supported 

TAPI SS UNEXPECTEDDATAVALUE SS error indicating unexpected data value on network side 


TAPI SS PWREGISTRATIONFAILURE SS error indicating change password failure. 
ТАРІ SS NEGATIVEPWCHECK SS error indicating negative password check. 


TAPI SS NUMBEROFPWATTEMPTSVIOLATION $$ error indicating barring password at- 
tempts violated. 


TAPI SS UNKNOWNALPHABET SS error indicating unknown SS data coding of alphabet 
TAPI SS USSDBUSY 55 error indicating USSD Busy(Already ss / ussd is ongoing). 
TAPI SS REJECTEDBYUSER SS operation rejected by user. 

TAPI SS REJECTEDBYNETWORK SS operation rejected by network. 


TAPI SS INVALIDDEFLECTEDTONUMBER SS error indicating the invalid deflected to num- 
ber. 


TAPI SS MAXNOMPTYEXCEEDED SS error indicating Maximum mpty is reached. 
TAPI SS RESOURCESNOTAVAILABLE SS error indicating resources not available in network. 
TAPI SS UNKNOWNERROR SS error indicating unknown error 


TAPI SS OEM NOT SUPPORTED If oem do not support any of SS requests, then this error will 
be returned back 


5.95.2.6 enum TelSsCliStatus t 


This enumeration defines the cli service status . 


Enumerator: 


TAPI CLI STATUS NOT PROVISONED Service not provided by the service provider 
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TAPI CLI STATUS PROVISIONED Service is provided by the service provider 


TAPI CLI STATUS ACTIVATED Service is activated at the network 
TAPI CLI STATUS UNKOWN Service status is unknown 

TAPI CLI STATUS TEMP RESTRICTED Service is temporarily restricted 
TAPI CLI STATUS TEMP ALLOWED Service is temporarily allowed 


5.95.2.7 enum TelSsForwardMode t 


This enumeration defines the forward mode . 


Enumerator: 


TAPI CALL FORWARD MODE DISABLE EV  Deactivate call forwarding 
TAPI CALL FORWARD MODE ENABLE EV Activate call forwarding 


TAPI CALL FORWARD MODE REGISTRATION EV Register Call forwarding 


ТАРІ CALL FORWARD MODE ERASURE EV De-register call forwarding 


5.95.2.8 enum TelSsForwardType t 
This enumeration defines the forward type . 


Enumerator: 


TAPI CS FORWARD TYPE VOICE EV Voice call forward 
ТАРІ CS FORWARD TYPE DATA EV Data call forward 
TAPI CS FORWARD TYPE FAX EV Fax call forward 


5.95.2.9 enum TelSsForwardWhen t 
/жж This enumeration defines the call forwarding flavor. 


Enumerator: 
TAPI SS FORWARD WHEN UNCONDITIONAL EV Unconditional 
TAPI SS FORWARD WHEN BUSY EV When Busy 
TAPI SS FORWARD WHEN NO ANSWER EV When No Reply 
TAPI SS FORWARD WHEN NOT REACHABLE EV When Not Reachable 
TAPI SS FORWARD WHEN ALL FORWARDING EV Forward АП Calls 


5.95.2.10 enum TelSsLineldentificationType_t 
These are the four types of identity presentation / restriction services. 


Enumerator: 


TAPI CALLING LINE IDENTITY PRESENTATION identify the party calling this phone 
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TAPI CALLING LINE IDENTITY RESTRICTION hide the identity of this phone when calling 
others 


TAPI CONNECTED LINE IDENTITY PRESENTATION identify the party to whom the call- 
ing party (this phone) is connected 


TAPI CONNECTED LINE IDENTITY RESTRICTION restrict yourself from being identified 
by incoming calls, such as forwarded calls 


TAPI CALLED LINE IDENTITY PRESENTATION Called line identity presentation 
TAPI CALLING NAME PRESENTATION Calling Name Presentation 


5.95.2.11 enum TelSsRestrictIDStatus t 
This enumeration defines the types of restrict identification . 


Enumerator: 
TAPI CALL RESTRICT ID DEPEND NETWORK EV Depend on Network 
TAPI CALL RESTRICT ID ENABLE EV Enable Restricted Call Id 
TAPI CALL RESTRICT ID DISABLE EV Disable Restricted Call Id 


5.95.2.12 enum TelSsStatus t 


The status of a supplementary service feature (e.g. Call Forwarding or Call Barring). 


These enumerated values should be used as masks 


Enumerator: 
TAPI SS STATUS ACTIVE Active Status 
TAPI SS STATUS REGISTERED SS Registered 
TAPI SS STATUS PROVISIONED Provision established 
TAPI SS STATUS QUIESCENT Provision established 
TAPI SS STATUS NOTHING Status Nothing 


5.95.2.13 enum TelSsTeleService t 


The types of telecommunication services are used for setting the statuses of supplementary services. They 
are typically not supported in IS-2000 or IS-136. See GSM 02.30 Annex C and GSM 22.030 Annex C. 


Enumerator: 
TAPI SS TS ALL TELE AND BEARER SERVICES АП Teleservices & Bearer Services 
TAPI SS TS ALL TELESERVICES АП Teleservices 
TAPI SS TS ALL SPEECH АП Speech Services 
TAPI SS TS ALL DATA TELESERVICES All Data Teleservices 
TAPI SS TS FACS АП Fax Service 
TAPI SS TS ALL TELESERVICES EXCEPT SMS АП teleservice except SMS 
TAPI SS TS ALL PLMN SPEC TELE PLMN specific teleservices 
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TAPI SS TS PLMN SPEC TELE 1 PLMN specific teleservice 1 
TAPI SS TS PLMN SPEC TELE 2 PLMN specific teleservice 2 
TAPI SS TS PLMN SPEC TELE 3 PLMN specific teleservice 3 
TAPI SS TS PLMN SPEC TELE 4 PLMN specific teleservice 4 
TAPI SS TS PLMN SPEC TELE 5 PLMN specific teleservice 5 
TAPI SS TS PLMN SPEC TELE 6 PLMN specific teleservice 6 
TAPI SS TS PLMN SPEC TELE 7 PLMN specific teleservice 7 
TAPI SS TS PLMN SPEC TELE 8 PLMN specific teleservice 8 
TAPI SS TS PLMN SPEC TELE 9 PLMN specific teleservice 9 
TAPI SS TS PLMN SPEC TELE A PLMN specific teleservice 10 
TAPI SS TS PLMN SPEC TELE B PLMN specific teleservice 11 
TAPI SS TS PLMN SPEC TELE C PLMN specific teleservice 12 
TAPI SS TS PLMN SPEC TELE D PLMN specific teleservice 13 
TAPI SS TS PLMN SPEC TELE E PLMN specific teleservice 14 
TAPI SS TS PLMN SPEC TELE F PLMN specific teleservice 15 
TAPI SS BS ALL BEARER SERVICES All PLMN specific bearer services 
TAPI SS BS ALL DATA CDS All Data CDS 

TAPI SS BS ALL ASYNCHRONOUS АП Asynchronous 

TAPI SS BS ALL SYNCHRONOUS All Synchronous 

TAPI SS BS DATA CIRCUIT SYNC All Data Circuit Synchronous 
TAPI SS BS DATA CIRCUIT ASYNC АП Data Circuit Asynchronous 
TAPI SS BS DATA ALL PDS All Data PDS 

TAPI SS BS ALL DATA PADCA All Data PADCA 

TAPI SS BS ALL PLMN SPEC BS All PLMN Spec BS 

TAPI SS BS PLMN SPEC TELE 1 PLMN specific bearer service 1 
TAPI SS BS PLMN SPEC TELE 2 PLMN specific bearer service 2 
TAPI SS BS PLMN SPEC TELE 3 PLMN specific bearer service 3 
TAPI SS BS PLMN SPEC TELE 4 PLMN specific bearer service 4 
TAPI SS BS PLMN SPEC TELE 5 PLMN specific bearer service 5 
TAPI SS BS PLMN SPEC TELE 6 PLMN specific bearer service 6 
TAPI SS BS PLMN SPEC TELE 7 PLMN specific bearer service 7 
TAPI SS BS PLMN SPEC TELE 8 PLMN specific bearer service 8 
TAPI SS BS PLMN SPEC TELE 9 PLMN specific bearer service 9 
TAPI SS BS PLMN SPEC TELE A PLMN specific bearer service 10 
TAPI SS BS PLMN SPEC TELE B PLMN specific bearer service 11 
TAPI SS BS PLMN SPEC TELE C PLMN specific bearer service 12 
TAPI SS BS PLMN SPEC TELE D PLMN specific bearer service 13 
TAPI SS BS PLMN SPEC TELE E PLMN specific bearer service 14 
TAPI SS BS PLMN SPEC TELE F PLMN specific bearer service 15 
TAPI SS TS ALL DATA All Data 

TAPI SS TS DATA CIRCUIT SYNC Data Circuit Sync 

TAPI SS TS MULTIPLE multiple 

TAPI SS TS TELEPHONY Telephony 

TAPI SS TS DATA CIRCUIT ASYNC Data Circuit Async 
TAPI SS TS DATA PACKET Data packet 
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5.05.2.14 enum TelSsType t 
This enumeration type defines the Supplementary service types 


Enumerator: 


TAPI SS TYPE BARRING Barring SS 

TAPI SS TYPE FORWARDING Forward SS 

TAPI SS TYPE WAITING Waiting SS 

TAPI SS TYPE IDENTIFICATION Identification SS 
TAPI SS TYPE CNAP CNAPSS 

TYPE SS TYPE USSD Unstructured supplementary data SS 


5.95.2.15 enum TelSsUssdIndType t 
This enumeration defines the ussd Indication Type 


Enumerator: 


TAPI USSD IND NOTIFY notify : to display ussd data to user 

TAPI USSD IND NO ACTION REQUIRE No further user action required 

TAPI USSD IND ACTION REQUIRE Further user action required 

TAPI USSD IND TERMINATED BY NET 0x03 : USSD terminated by network 
TAPI USSD IND OTHER CLIENT 0x04 : other local client has responded 

TAPI USSD IND NOT SUPPORT 0x05 : operation not supported 

TAPI USSD IND TIME OUT 0x06: Time out when there is no response from network 


5.95.2.16 enum TelSsUssdRespType t 
This enumeration defines the ussd response type 


Enumerator: 
TAPI USSD RES UNKNOWN ALPHABET USSD data is unknown 
TAPI USSD RES DISPL BUSY USSD Data response is display busy 
TAPI USSD RES ОК USSD Data is encoded and properly propagated 
TAPI USSD RES NONE NO USSD Response from client 
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5.96 Utility Data Structures 


Files 


* file TelUtility.h 


This file serves as a "C" header file defines structures for Utility Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


* struct TelTapiVersionInfo t 
* struct TelTapiTunnelInfo t 
e struct TelTapiErrorInfo t 


Enumerations 


* enum TapiResult t { 


TAPI API SUCCESS, TAPI API INVALID INPUT, TAPI API INVALID PTR, TAPI API - 
INVALID CALL STATE, 


TAPI API NOT SUPPORTED, TAPI API DEPRICATED, TAPI API SYSTEM OUT OF - 
MEM, ТАРІ АРІ SYSTEM КРС LINK. DOWN, 


TAPI API MODEM POWERED OFF, ТАРІ АРІ SERVICE NOT READY, ТАРІ АРІ - 
SERVER FAILURE, ТАРІ АРІ ОЕМ PLUGIN FAILURE, 


TAPI API INVALID CALL HANDLE, TAPI API INVALID DATA LEN, TAPI API SIM - 
NOT FOUND, TAPI API SIM BUSY, 


TAPI API SIM INVALID CARD TYPE, TAPI API SIM CARD PERMANENT ERROR, 
ТАРІ АРІ SIM. NOT INITIALIZED, ТАРІ АРІ REQUEST MAX IN PROGRESS, 


TAPI API OFFLINE MODE ERROR, TAPI EVENT CLASS UNKNOWN, TAPI EVENT - 
UNKNOWN, TAPI REGISTRATION FAILURE } 


5.96.1 Enumeration Type Documentation 
5.96.1.1 enum TapiResult t 


Below enumerations are the return codes of TAPI АРГ5 


Enumerator: 


TAPI API SUCCESS No Error occurred 

TAPI API INVALID INPUT Input values are not correct in TAPI Library 
TAPI API INVALID PTR Invalid pointer 

TAPI API INVALID CALL STATE request failed due to invalid call state 


TAPI API NOT SUPPORTED The feature corresponding to requested API is not supported. This 
may be due to market/network/vendor reasons such as the feature is not available in the network. 


TAPI API DEPRICATED This API is deprecated and will be so in future also 
TAPI API SYSTEM OUT OF MEM Out of memory 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


208 


Module Documentation 


TAPI API SYSTEM RPC LINK DOWN RPC link down 
TAPI API MODEM POWERED OFF The Modem is powered off 


TAPI API SERVICE NOT READY Phone was powered on, but yet to receive the power up com- 
pleted notification 


ТАРІ АРІ SERVER FAILURE error occurred in Telephony server 

TAPI API OEM PLUGIN FAILURE Plug-in layer failure 

TAPI API INVALID CALL HANDLE Invalid call handle 

TAPI API INVALID DATA LEN Invalid data length 

TAPI API SIM NOT FOUND Sim is not present / removed 

TAPI API SIM BUSY SIM is busy 

ТАРІ АРІ SIM INVALID CARD TYPE біп card is unknown 

TAPI API SIM CARD PERMANENT ERROR SIM error/blocked state 

TAPI API SIM NOT INITIALIZED SIM has not initialized yet (waiting for PIN verification, etc) 


TAPI API REQUEST MAX IN PROGRESS Maximum number of API Request for the same 
service are already in progress 


TAPI API OFFLINE MODE ERROR OEM Telephony Provider is in Offline mode. 
TAPI EVENT CLASS UNKNOWN Event class specified is not present in Event Class list. 
TAPI EVENT UNKNOWN Event specified is not present in TAPI Unsolicited Event list. 
TAPI REGISTRATION FAILURE Callback Registration/De-registration failed 
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6.1 TelCallCugInfo t Struct Reference 


#include <TelCall.h> 


6.1.1 Detailed Description 


This data structure defines the CUG information. 


Data Fields 

* BOOL bCugFlag 

* unsigned int Index 

* TelCallCugOptions t Option 
6.1.2. Field Documentation 


6.1.21 BOOL TelCallCugInfo t::bCugFlag 


Closed User Group flag - it holds TRUE when it has data and FALSE otherwise. 


6.1.2.2 unsigned int TelCallCugInfo t::Index 


CUG Index value 


6.1.2.3 TelCallCugOptions t TelCallCugInfo t::Option 


Cug option type 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.2 TelCallEndInfo t Struct Reference 


#include <TelCall.h> 


6.2.1 Detailed Description 


This structure contains information about Call end informationl. 


Data Fields 


* TelCallCause t CallEndCause 
* unsigned int pCallHandle 

* unsigned int CallStartTime 

* unsigned int CallEndTime 


6.2.2 Field Documentation 
6.2.2.1 TelCallCause t TelCallEndInfo t::CallEndCause 


End cause for the call indicates whether the call is released normally or due to other cause 


6.2.2.2 unsigned int TelCallEndInfo t::pCallHandle 


Call handle 


6.2.2.3 unsigned int TelCallEndInfo t::CallStartTime 


Start time of the call(time in secs) 


6.2.2.4 unsigned int TelCallEndInfo t::CallEndTime 


End time of the call(time in secs) 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.3 TelCallIncomingCallInfo t Struct Reference 


#include <TelCall.h> 


6.3.1 Detailed Description 


This structure contains the incoming call information. 


Data Fields 


unsigned int CallHandle 

TelCallType t CallType 

TelSsLinelIdentificationType t CliPresentationIndicator 

char szCallingPartyNumber [ТАРІ CALL DIALDIGIT LEN MAX-«1] 

char szCallingPartySubAddress [ТАРІ САШ, SUBADDRESS LEN MAX-«1] 
TelCallingNamelInfo t CallingNameInfo 

TelCallUusInfo t UusInfo 

TelCallAlertingPattern t AlertingPattern 

TelCallRedirectionInfo t RedirectInfo 

int Signal 


6.3.2. Field Documentation 
6.3.2.1 unsigned int TelCallIncomingCallInfo t::CallHandle 


Handle for the call 


6.3.2.2 TelCallType t TelCallIncomingCallInfo_t::CallType 


Call type 


6.3.2.3  TelSsLineldentificationType t TelCallIncomingCallInfo t::CliPresentationIndicator 


Calling Party presentation indicator 


6.3.2.4 char TelCallIncomingCallInfo t::szCallingPartyNumber[TAPI CALL DIALDIGIT - 
LEN МАХ-11 


caller number,null terminated ASCII 


6.3.2.5 char TelCallIncomingCallInfo t::szCallingPartySubAddress|(TAPI CALL - 
SUBADDRESS LEN МАХ+1] 


called subaddress,null terminated ASCII 
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6.3.2.6 "TelCallingNamelnfo t TelCallIncomingCallInfo t::CallingNameInfo 


Call name info. If there is no information from network, this information will be NULL. 


6.3.2.7 TelCallUusInfo_t TelCallIncomingCallInfo t::UusInfo 


User -to User signaling information. (UUSI only is supported). If there is no information from network, 
this information will be NULL. 


6.3.2.8 TelCallAlertingPattern_t TelCallIncomingCallInfo t::AlertingPattern 


Alerting pattern 


6.3.2.9  TelCallRedirectionInfo t TelCallIncomingCallInfo t::RedirectInfo 


The data for the Call Redirect information. If there is no information from network, this information will 
be NULL. 


6.3.2.10 int TelCallIncomingCallInfo t::Signal 


Signal Value received from the network (ref: 3gpp spec). 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.4 TelCallingNamelInfo t Struct Reference 


#include <TelCall.h> 


6.4.1 Detailed Description 


This structure defines the calling name information 


Data Fields 


* TelCallNameMode_t NameMode 
е char szNameData [ТАРІ CALLING NAME SIZE MAX] 


6.4.2 Field Documentation 
6.4.2.1  TelCallNameMode t TelCallingNameInfo t::NameMode 


Display mode of the szNameData. 


6.4.2.2 char TelCallingNamelnfo t::szzNameData(TAPI CALLING NAME SIZE MAX] 


Calling party name string. 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.5 TelCallRedirectionInfo t Struct Reference 


#include <TelCall.h> 


6.5.1 Detailed Description 


This structure contains information about call redirection details. 


Data Fields 


• char szRedirectedNumber [ТАРІ CALL DIALDIGIT LEN МАХ+1] 
е char szRedirectSubAddress [ТАРІ САШ, SUBADDRESS. LEN МАХ+1] 


6.5.2 Field Documentation 


6.5.2.1 char TelCallRedirectionInfo_t::szRedirectedNumber[TAPL CALL DIALDIGIT LEN - 
МАХ+1] 


Redirected party number 


6.5.2.2 char TelCallRedirectionInfo t::szRedirectSubAddress|(TAPI CALL SUBADDRESS - 
LEN MAX-41] 


Redirect party sub-address 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.6 TelCallSetupParams t Struct Reference 


#include <TelCall.h> 


6.6.1 Detailed Description 


This structure contains information about an outgoing call. 


Data Fields 


TelCallType t CallType 

char szNumber [ТАРІ CALL. DIALDIGIT LEN МАХ+1] 

char szCalledPartySubAddress [ТАРІ САШ, SUBADDRESS LEN МАХ+1] 
TelCallIdentityMode t IdentityMode 

TelCallCugInfo t pCugInfo 

TelCallUusInfo, t pUusInfo 


6.6.2 Field Documentation 
6.6.2.1 TelCallType_t TelCallSetupParams t::CallType 


sets type of call (voice, data, video, emergency) 


6.6.2.2 char TelCallSetupParams t::szNumber[TAPI CALL DIALDIGIT LEN MAX-41] 


A string containing the destination phone number. This follows the dial number format. 


6.6.2.3 char TelCallSetupParams t::szCalledPartySubAddress|(TAPI CALL SUBADDRESS - 
LEN MAX41] 


A string containing the destination sub-address. This is Null terminated string. This is an optional param- 
eter and it can be NULL. 


6.6.2.4 TelCallIdentityMode t TelCallSetupParams t::IdentityMode 


Sets Calling Line Identity mode. If default value TAPI IDENTITY DEFAULT is set, OEM will set the 
default value. 


6.6.2.5 "TelCallCugInfo t TelCallSetupParams_t::pCugInfo 


Closed User Group Info (Closed User Group Info).This is an optional parameter and it can be NULL. 


6.6.2.6 TelCallUusInfo_t TelCallSetupParams t::pUusInfo 


User -to User signaling information. This is an optional parameter and it can be NULL. 


The documentation for this struct was generated from the following file: 
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* TelCall.h 
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6.7 TelCallStatus_t Struct Reference 


#include <TelCall.h> 


6.7.1 Detailed Description 


This structure contains information about call status. 


Data Fields 


* BOOL bMoCall 

* char pNumber [ТАРІ CALL. DIALDIGIT LEN MAX-«1] 
e TelCallType t CallType 

* TelCallActiveState t CallState 

* BOOL bConferenceState 


6.7.2 Field Documentation 
6.7.2. BOOL TelCallStatus t::bMoCall 


Status will be yes for MO Call. If MT call, then FALSE 


6.7.2.2 char TelCallStatus t::pNumber[TAPI CALL DIALDIGIT LEN МАХ+1] 


Mobile Number 


6.7.2.3  TelCallType t TelCallStatus t::CallType 


specifies type of call (voice, data, emergency) 


6.7.2.4 TelCallActiveState t TelCallStatus t::CallState 


Current Call state 


6.7.2.5 BOOL TelCallStatus t::bConferenceState 


Whether Call is in Conference or not 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.8 TelCallUserDatalnfo t Struct Reference 


#include <TelCall.h> 


6.8.1 Detailed Description 


This structure contains information about user data information. 


Data Fields 


* unsigned int CallHandle 
* TelCallUusInfo_t UusInfo 


6.8.2 Field Documentation 
6.8.2.1 unsigned int TelCallUserDataInfo_t::CallHandle 


Call Handle 


6.8.2.2 TelCallUusInfo_t TelCallUserDataInfo_t::UusInfo 


User-User Information(UUS1) received from the network 


The documentation for this struct was generated from the following file: 


* TelCall.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


6.9 TelCallUusInfo t Struct Reference 219 


6.9 TelCallUusInfo t Struct Reference 


#include <TelCall.h> 


6.9.1 Detailed Description 


This structure defines the UUS information 


Data Fields 


* TelCallUusType t UusType 

* TelCallUusProtocolType t ProtocolType 

* BOOL bMoreDataPresent 

* unsigned short UusDataLen 

e unsigned char UusData [ТАРІ САШ, UUS. DATA LEN MAX] 


6.9.2 Field Documentation 
6.9.21 TelCallUusType_t TelCallUusInfo t::UusType 


User-User type defined as per 3GPP 24.008. 


6.9.2.2 TelCallUusProtocolType_t TelCallUusInfo t::ProtocolType 


User-User Protocol type defined as per 3GPP 24.008 


6.9.2.3 BOOL TelCallUusInfo_t::bMoreDataPresent 


Is more user-user information present 


6.9.2.4 unsigned short TelCallUusInfo t::UusDataLen 


User-user data length. 


6.9.2.5 unsigned char TelCallUusInfo t::UusData[(TAPI CALL UUS DATA LEN MAX] 


User-user data. 


The documentation for this struct was generated from the following file: 


* TelCall.h 
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6.10 TelNetworkConfigSettings t Struct Reference 


#include <TelNetwork.h> 


6.10.1 Detailed Description 


This structure has information related to network startup. 


Data Fields 


* BOOL bAutoSelection 

* BOOL bPowerOnGprsAttach 

e unsigned int NoOfNwModePresent 

* TelNetworkMode_t NetworkOrder [TAPI_ NETWORK, ORDER, MAX] 
* TelNetworkServiceDomain t ServiceDomain 

* TelNetworkMode t NetworkMode 


6.10.2 Field Documentation 
6.10.2.1 BOOL TelNetworkConfigSettings t::bAutoSelection 


Determines whether the Auto selection mode is enabled or not 


6.10.2.2 BOOL TelNetworkConfigSettings_t::bPowerOnGprsAttach 


Determines whether the Power on with GPRS attach is enabled or not 


6.10.2.3 unsigned int TelNetworkConfigSettings t:: NoOfNwModePresent 


No of network mode provided in the network, order array list 


6.10.2.4 TelNetworkMode t TelNetworkConfigSettings t::NetworkOrder[TAPI NETWORK - 
ORDER MAX] 


This is array of TAPIL NETWORK, ORDER MAX size of TelNetworkMode t type 


6.10.2.5  TelNetworkServiceDomain t TelNetworkConfigSettings t::ServiceDomain 


This member sets the Service domain 


6.10.2.6 TelNetworkMode_t TelNetworkConfigSettings t::NetworkMode 


This member sets the Network mode 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.11  TelNetworkInfo t Struct Reference 


#include <TelNetwork.h> 


6.11.1 Detailed Description 


This structure has network information. 


Data Fields 


* TelNetworkServiceLevel t ServiceLevel 
• TelNetworkSystemId t SysId 

* BOOL bRoaming 

* BOOL bDisplaySpn 

* BOOL bDisplayRplmn 


6.11.2 Field Documentation 
6.11.2.1 TelNetworkServiceLevel t TelNetworkInfo t::ServiceLevel 


Service level available( Full Service or Limited service etc) 


6.11.2.2 TelNetworkSystemlId t TelNetworkInfo t::SysId 


System ID information 


6.11.2.3 BOOL TelNetworkInfo t::bRoaming 


Roaming PLMN or not 


6.11.2.4 BOOL TelNetworkInfo t::bDisplaySpn 


Service Provider Name should be displayed or not 


6.11.2.5 BOOL TelNetworkInfo t::bDisplayRplmn 


Display of Registered PLMN required or not. 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.12 TelNetworkList t Struct Reference 


#include <TelNetwork.h> 


6.12.1 Detailed Description 


This structure defines the network list. 


Data Fields 


* unsigned int NumOfNw Available 
• TelNetworkSystemlId t SystemList [ТАРІ NETWORK, LIST MAX] 


6.12.2 Field Documentation 
6.12.2.1 unsigned int TelNetworkList t:: NumOfNwAvailable 


Count for Network list 


6.12.2.2 TelNetworkSystemId t TelNetworkList t::SystemList|(TAPI NETWORK LIST MAX] 


List of Networks available 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.13 TelNetworkRadioInfo_t Struct Reference 


#include <TelNetwork.h> 


6.13.1 Detailed Description 


This structure defines the Radio information. 


Data Fields 


* unsigned short RxLevel 
* unsigned short RxQuality 
* unsigned short RssiBar 


6.13.2 Field Documentation 


6.13.2.1 unsigned short TelNetworkRadioInfo t::RxLevel 


Received radio signal level from the wireless stack.Radio signal strength indicator (RSSI) level.RSSI in 
positive dBm i.e. 75 means -75dBm.The valid range for AMPS:-110 to -89 dBm800 CDMA:-105 to -90 


dBm1900 CDMA: -108 to -93 dBm GSM/WCDMA: -105 to -60 dBm 


6.13.2.2 unsigned short TelNetworkRadioInfo t::RxQuality 


Radio signal quality received from the wireless stack. 


6.13.2.3 unsigned short TelNetworkRadiolInfo t::RssiBar 


Signal bars stating the signal strength 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.14 TelNetworkSystemld t Struct Reference 


Шіпсіпде <TelNetwork.h> 


6.14.1 Detailed Description 


This structure defines the network system information. 


Data Fields 


TelNetworkSystemType t SystemType 
TelNetworkServiceType t ServiceType 
TelNetworkSystemIdFormat. t SysIdFormat 
TelNetworkMode t NetworkMode 

unsigned long SysId 

BOOL bPImnForbidden 

BOOL bHome 

BOOL bEquivalentPlmn 

BOOL bNetworkldentityAvail 

BOOL bNetworkTimeAvail 

BOOL bNetworkTimeZoneAvail 

BOOL bNetworkDlsAvail 

char szSystemName [ТАРІ NETWORK NAME LEN MAX] 
char szSpn [TAPI NETWORK SPN LEN MAX] 
TelNetworkTimeAndZone t NetworkTimeZone 
BOOL bMncIncludesPesDigit 


6.14.2 Field Documentation 
6.14.2.1 TelNetworkSystemType t TelNetworkSystemId t::SystemType 


Network system technologies like GSM, CDMA, WCDMA, WLAN etc 


6.14.2.2 TelNetworkServiceType t TelNetworkSystemId_t::ServiceType 


Network service type - Cs, Ps or combined 


6.14.2.3 TelNetworkSystemIdFormat t TelNetworkSystemId t::SysIdFormat 


SID or PLMN based on system type 


6.14.2.4 TelNetworkMode t TelNetworkSystemId t::NetworkMode 


Network mode Information 


6.14.2.5 unsigned long TelNetworkSystemlId t::SysId 


PLMN Information 
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6.14.2.6 BOOL TelNetworkSystemId_t::bPlmnForbidden 


Forbidden PLMN or Not 


6.14.2."7 BOOL TelNetworkSystemId t::bHome 


Home PLMN Or not 


6.14.2.8 BOOL TelNetworkSystemlId t::bEquivalentPlmn 


Equivalent PLMN Or not 


6.14.2. BOOL TelNetworkSystemId_t::bNetworkIdentityAvail 


Network Identity Available or not 


6.14.2.10 BOOL TelNetworkSystemId t::bNetworkTimeAvail 


Network Time Available or not 


6.14.2.11 BOOL TelNetworkSystemId t::bNetworkTimeZoneAvail 


Network Timezone Available or not 


6.14.2.12 BOOL TelNetworkSystemId t::bNetworkDlsAvail 


Network DLS available or not 


6.14.2.13 char TelNetworkSystemlId t::szSystemName[TAPI NETWORK МАМЕ LEN MAX] 


PLMN Name or Network Name (Null terminated string) 


6.14.2.14 char TelNetworkSystemlId t::szSpn[TAPI NETWORK  SPN LEN MAX] 


Service Provider Name (Null Terminated string) 


6.14.2.15  TelNetworkTimeAndZone t TelNetworkSystemId_t::NetworkTimeZone 


If NetwotkTimezone present, then timezone value 


6.14.2.16 BOOL TelNetworkSystemId_t::bMncIncludesPcsDigit 


To determine whether PLMN is US PLMN or not 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.15 TelNetworkTimeAndZone t Struct Reference 


#include <TelNetwork.h> 


6.15.1 Detailed Description 


This structure defines the network time and zone information. 


Data Fields 


unsigned short Year 


unsigned short Month 


unsigned short Day 


unsigned short Hour 


unsigned short Minute 


unsigned short Second 


unsigned short TimeZone 
TelNetworkDayLightSavingAdj_t DaylightSave 


6.15.2 Field Documentation 
6.15.2.1 unsigned short TelNetworkTimeAndZone_t:: Year 


Year information 


6.15.2.2 unsigned short TelNetworkTimeAndZone_t::Month 


Month information 


6.15.2.3 unsigned short TelNetworkTimeAndZone_t::Day 


Day 


6.15.2.4 unsigned short TelNetworkTimeAndZone_t::Hour 


Hour 


6.15.2.5 unsigned short TelNetworkTimeAndZone_t::Minute 


Minute 


6.15.2.6 unsigned short TelNetworkTimeAndZone_t::Second 


Second 
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6.15.2.7 unsigned short TelNetworkTimeAndZone t::TimeZone 


Network time zone 


6.15.2.8  TelNetworkDayLightSavingAdj t TelNetworkTimeAndZone t::DaylightSave 


day light saving adjustment time 


The documentation for this struct was generated from the following file: 


* TelNetwork.h 
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6.16 TelSimApnData t Struct Reference 


#include <TelSim.h> 


6.16.1 Detailed Description 


This structure defines the Access Point Name data 


Data Fields 


* unsigned long AclLen 
e unsigned short Acl [ТАРІ SIM. ACL MAX LEN] 


6.16.2 Field Documentation 
6.16.2.1 unsigned long TelSimApnData_t::AclLen 


Acess point name control list length. 


6.16.2.2 unsigned short TelSimApnData_t::Acl[TAPI_SIM_ACL_MAX LEN] 


Acl list 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.17 TelSimCallbackEvent_t Struct Reference 


#include <TelSim.h> 


6.17.1 Detailed Description 


This structure is used as a callback event notificaions in Telephony for applictions. 


Data Fields 


* int RequestId 

* int EventStatus 

* unsigned int DataLen 

e unsigned char ж pData 

* TelTapiEventType t EventType 


6.17.2 Field Documentation 
6.17.2.1 int TelSimCallbackEvent t::RequestId 


Handle to SIM -RequestId in LiMo 


6.17.2.2 int TelSimCallbackEvent t::EventStatus 


SIM event status - Operation result or Access result depending on API 


6.17.2.3 unsigned int TelSimCallbackEvent t::DataLen 


Data length 


6.17.2.4 unsigned char« TelSimCallbackEvent t::pData 


Data associated with the event 


6.17.2.5 TTelTapiEventType t TelSimCallbackEvent t::EventType 


Event type 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.18 TelSimDeviceContext t Struct Reference 


#include <TelSim.h> 


6.18.1 Detailed Description 


This structure defines the SIM status data and SIM device context data 


Data Fields 


* TelSimStatusData_t SimStatusData 
* TelSimDeviceContextData_t SimDeviceCtxData 


6.18.2 Field Documentation 
6.18.2.1 TelSimStatusData t TelSimDeviceContext t::SimStatusData 


SIM data. 


6.18.2.2 TelSimDeviceContextData t TelSimDeviceContext t::SimDeviceCtxData 


SIM device context data. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.19 TelSimDeviceContextData t Struct Reference 


Шіпсіпде <TelSim.h> 


6.19.1 Detailed Description 


This structure defines the SIM device context data 


Data Fields 


BOOL blIsDeviceCtxdataValid 
BOOL bBdnEnable 

BOOL bFdnEnable 

BOOL bAclIEnable 

BOOL bImsilInvalidated 
unsigned long apnCount 


union { 
TelSimSstInfo. t SstInfo 
TelSimUstInfo. t UstInfo 
) SstData 


TelSimGroupldentifierInfo t GidlInfo 
TelSimGroupldentifierInfo t Gid2Info 
TelSimApnData t ApnData 


6.19.2 Field Documentation 
6.19.2.1 BOOL TelSimDeviceContextData_t::bIsDeviceCtxdata Valid 


Indicates if device conext (this) data is valid. 


6.19.22 BOOL TelSimDeviceContextData t::bBdnEnable 


BDN mode enabled or not. 


6.19.2.3 BOOL TelSimDeviceContextData t::bFdnEnable 


FDN mode enabled or not. 


6.19.2.4 BOOL TelSimDeviceContextData t::bAcIEnable 


ACL(Access Point Name Control List) enabled or not. 


6.19.2.5 BOOL TelSimDeviceContextData t::bImsilnvalidated 


IMSI Invalidated or not. 
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6.19.2.6 unsigned long TelSimDeviceContextData t::apnCount 


Number of Access point name. 


6.19.2.7 TelSimSstInfo t TelSimDeviceContextData t::SstInfo 


SIM Service table information. 


6.19.2.8 TelSimUstInfo t TelSimDeviceContextData t::UstInfo 


USIM Service table information. 


6.19.2.9 union { ... } TelSimDeviceContextData t::SstData 


SS data information 


6.19.2.10  TelSimGroupldentifierInfo t TelSimDeviceContextData t::GidlInfo 


Group Identifier 1. 


6.19.2.11  TelSimGroupldentifierInfo t TelSimDeviceContextData t::Gid2Info 


Group Identifier 2. 


6.19.2.12 TelSimApnData t TelSimDeviceContextData t::ApnData 


Access point data. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.20 TelSimEccData t Struct Reference 


#include <TelSim.h> 


6.20.1 Detailed Description 


This data structure defines the data for the Ecc information. 


Data Fields 


* TelUsimEccInfo_t UeccInfo [TAPI_SIM_UECC_RECORD_COUNT_MAX] 
е TelSimEccInfo_t EccInfo 


6.20.2 Field Documentation 


6.20.2.1 TelUsimEccInfo t TelSimEccData t::UeccInfo[TAPI SIM UECC RECORD COUNT - 
MAX] 


Usim Emergency Call Code information structure 


6.20.2.  TelSimEccInfo t TelSimEccData t::EccInfo 


Emergency Call Code information 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.21 TelSimEccInfo t Struct Reference 


#include <TelSim.h> 


6.21.1 Detailed Description 


This enumeration defines the Ecc information. 


Data Fields 


TAPI SIM ECC CODE LEN 
* char szEcc2 [TAPI SIM ECC CODE LEN 


• char szEccl | ] 
[ ] 
* char szEcc3 (TAPI SIM ECC CODE LEN] 
[ ] 
[ ] 


* char szEcc4 [TAPI SIM ECC CODE LEN 
* char szEcc5 [TAPI SIM ECC CODE LEN 


6.21.2 Field Documentation 


6.21.2.1 char TelSimEccInfo_t::szEcc1[TAPL SIM ECC CODE LEN] 


Emergency Call Code 1 info. ECC is coded in BCD format. Unused bytes is set to OxFF. 


6.21.2.2 char TelSimEccInfo t::szEcc2[|TAPI SIM ECC CODE LEN] 


Emergency Call Code 2 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


6.21.2.3 char TelSimEccInfo t::szEcc3[|TAPI SIM ECC CODE LEN] 


Emergency Call Code 3 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


6.21.2.4 char TelSimEccInfo t::szEccd[TAPI SIM ECC CODE LEN] 


Emergency Call Code 4 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


6.21.2.5 char TelSimEccInfo_t::szEcc5[TAPL SIM ECC CODE LEN] 


Emergency Call Code 5 info ECC is coded in BCD format. Unused bytes is set to OXFF. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.22 TelSimEvent_t Struct Reference 


#include <TelSim.h> 


6.22.1 Detailed Description 


This structure is used as a callback event notifications for applications. 


Data Fields 


* int RequestId 

* int EventStatus 

* unsigned int DataLen 
e unsigned char ж pData 


6.22.2 Field Documentation 
6.22.2.1 int TelSimEvent t::RequestId 


RequestId 


6.22.2.2 int TelSimEvent t::EventStatus 


Sim Event Status 


6.22.2.3 unsigned int TelSimEvent t::DataLen 


Data length 


6.22.2.4 unsigned char« TelSimEvent t::pData 


Data associated with the event 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.23 TelSimFileAccessGeneralResp_t Struct Reference 


#include <TelSim.h> 


6.23.1 Detailed Description 


This data structure defines the response for SIM update file. 


Data Fields 


• TelSimFileID_t Fileld 
* TelSimAccessType_t AccessType 


6.23.2 Field Documentation 
6.23.2.1 TelSimFileID_t TelSimFileAccessGeneralResp t::FileId 


SIM file ID 


6.23.2.2 TelSimAccessType t TelSimFileAccessGeneralResp t::AccessType 


Access type 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.24 TelSimFileID t Struct Reference 


#include <TelSim.h> 


6.24.1 Detailed Description 


This structure contains information about File name and path. 


Data Fields 


* TelSimFileName t FileName 
* unsigned char szPath [128] 


6.24.2 Field Documentation 
6.24.2.1 TelSimFileName t TelSimFileID t::FileName 


Elementary FileName enumeration 


6.24.2.2 unsigned char TelSimFileID t::szPath[128] 


Absolute szPath of the elementary file. [Null Terminated] 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.25 TelSimFileInfo_t Struct Reference 


#include <TelSim.h> 


6.25.1 Detailed Description 


This structure defines the SIM device Elementary file information read 


Data Fields 


BOOL bValid 
TelSimFileID_t Fileld 
TelSimFileType_t FileType 
TelSimAcl_t AcRead 
TelSimAcl_t AcUpdate 
TelSimAcl_t AcInvalidate 
TelSimAcl_t AcRehabilitate 
unsigned long RecordLen 
unsigned long RecordCount 
unsigned long FileSize 


6.25.2 Field Documentation 
6.25.21 BOOL TelSimFileInfo_t::b Valid 


Valid or not 


6.25.2.2  TelSimFileID t TelSimFileInfo t::FileId 


File identifier 


6.25.2.3  TelSimFileType t TelSimFileInfo t::FileType 


File type and structure 


6.25.2.4 TelSimAcl t TelSimFileInfo t::AcRead 


Access condition for read operation 


6.25.2.5 TelSimAcl_t TelSimFileInfo t::AcUpdate 


Access condition for update operation 


6.25.2.6 TelSimAcl t TelSimFileInfo t::AcInvalidate 


Access condition for invalidate operation 
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6.25.27 TelSimAcl t TelSimFileInfo t::AcRehabilitate 


Access condition for rehabilitate operation 


6.25.2.8 unsigned long TelSimFileInfo t::RecordLen 


Length of one record in file 


6.25.2.9 unsigned long TelSimFileInfo t::RecordCount 


Number of records in file 


6.25.2.10 unsigned long TelSimFileInfo t::FileSize 


File size 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.26 TelSimGrouplIdentifierInfo t Struct Reference 


#include <TelSim.h> 


6.26.1 Detailed Description 


This data structure defines the data for the group identifier information. 


Data Fields 


e unsigned short GroupIdentifierLen 
e char szGroupldentifier [ТАРІ SIM GROUP IDENTIFIER LEN MAX] 


6.26.2 Field Documentation 
6.26.2.1 unsigned short TelSimGroupIdentifierInfo_t::GroupIdentifierLen 


Group identifier length 


6.26.2.2 char TelSimGroupldentifierInfo t::szGrouplIdentifier[TAPI SIM GROUP - 
IDENTIFIER LEN MAX] 


Group identifier 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.27 TelSimIccIdInfo t Struct Reference 


#include <TelSim.h> 


6.27.1 Detailed Description 


This data structure defines the data for the Iccid information. 


Data Fields 


* unsigned long IccidLength 
* unsigned short Iccid [TAPI_SIM_ICCIDLENGTH] 


6.27.2 Field Documentation 
6.27.2.1 unsigned long TelSimIccIdInfo t::IccidLength 


Integrated Circuit Card id length 


6.27.2.2 unsigned short TelSimIccIdInfo t::Iccid| TAPI SIM ICCIDLENGTH] 


Unique card identification number 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.28  TelSimImsilnfo t Struct Reference 


#include <TelSim.h> 


6.28.1 Detailed Description 


This data structure defines the data for the Imsi information. 


Data Fields 


* BOOL bValid 

e char szMcc [ТАРІ SIM MCC CODE LEN-«1] 
e char szMnc [ТАРІ SIM MNC CODE LEN-1] 
e char szMsin [ТАРІ SIM MSIN CODE LEN-«1] 


6.28.2 Field Documentation 
6.28.21 BOOL TelSimImsilnfo t::bValid 


Valid( ACTIVATE) IMSI (TRUE) or Deactivated (FALSE) 


6.28.2.2 char TelSimImsiInfo_t::szMcc[TAPI_SIM_MCC_CODE_LEN+1] 


mobile country code 


6.28.2.3 char TelSimImsilnfo t::szMnc[TAPI SIM MNC CODE LEN-1] 


mobile network code 


6.28.2.4 char TelSimImsilInfo t::szzMsin[|TAPI SIM MSIN CODE LEN-1] 


mobile station identification number 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.29 TelSimLanguageInfo t Struct Reference 
#include <TelSim.h> 


6.29.1 Detailed Description 


This data structure defines the data for the Language information. 


Data Fields 


* unsigned long LpCount 
• TelSimLangIndicationCode_t lp [ТАРІ SIM LI MAX LEN] 


6.29.2 Field Documentation 
6.29.2.1 unsigned long TelSimLanguageInfo t::LpCount 


Language preference count; zero indicates that the LP file is not available or it doesn't have any data. 


6.29.2.2  TelSimLanglIndicationCode t TelSimLanguagelnfo t::Ip|TAPI SIM LI MAX LEN] 


Language preference code 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.30 TelSimPb2gData t Struct Reference 


#include <TelSim.h> 


6.30.1 Detailed Description 


This data struture defines the 2G phone book data storage. 


Data Fields 


unsigned short NumLen 

unsigned short NumType 

unsigned short NameLen 

unsigned short NameEncryptType 

unsigned short Number [TAPI_SIM_NUM_TEXT_MAX_LEN] 
unsigned short Name [TAPI_SIM_NUM_TEXT_MAX_LEN] 


6.30.2 Field Documentation 
6.30.2.1 unsigned short TelSimPb2gData_t::NumLen 


Number length 


6.30.2.2 unsigned short TelSimPb2gData_t::NumType 


Number type [refer to TelSimTypeOfNum_t] 


6.30.2.3 unsigned short TelSimPb2gData t::NameLen 


Name string length 


6.30.2.4 unsigned short TelSimPb2gData_t::NameEncryptType 


Name string encryption type [refer to TelSimTextEncrypt_t] 


6.30.2.5 unsigned short TelSimPb2gData t::Number[TAPI SIM NUM TEXT MAX LEN] 


Number data 


6.30.2.6 unsigned short TelSimPb2gData t::Name[TAPI SIM NUM TEXT MAX LEN] 


Name string 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.31 TelSimPbEntryInfo_t Struct Reference 


#include <TelSim.h> 


6.31.1 Detailed Description 


This data structure gives the phone book entry information. 


Data Fields 


TelSimPbFileType_t StorageFileType 
unsigned short PbIndexMin 

unsigned short PbIndexMax 
unsigned short PbNumLenMax 
unsigned short PbTextLenMax 


6.31.2 Field Documentation 
6.31.2.1 TelSimPbFileType t TelSimPbEntryInfo_t::StorageFileType 


Storage file type 


6.31.2.2 unsigned short TelSimPbEntryInfo t::PbIndexMin 


Phone book minimum index 


6.31.2.3 unsigned short TelSimPbEntryInfo_t::PbIndexMax 


Phone book maximum index 


6.31.2.4 unsigned short TelSimPbEntryInfo_t::PbNumLenMax 


Phone number maximum length 


6.31.2.5 unsigned short TelSimPbEntryInfo_t::PbTextLenMax 


Text maximum length 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.32 TelSimPbReadResp_t Struct Reference 


#include <TelSim.h> 


6.32.1 Detailed Description 


This data structure gives the phone book read response information. 


Data Fields 


* TelSimPbAccessResult t PbAccessResult 
* TelSimPbRecordData t PbStorageData 


6.32.2 Field Documentation 
6.32.2.1 TelSimPbAccessResult_t TelSimPbReadResp t::PbAccessResult 


Indicates the result of phonebook update/read operation. 


6.32.2.2  TelSimPbRecordData t TelSimPbReadResp t::PbStorageData 


Data read from the phonebook file. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.33 TelSimPbRecordData t Struct Reference 


#include <TelSim.h> 


6.33.1 Detailed Description 


This structure defines the Phone book record data. 


Data Fields 


* TelSimPbFileType t StorageFileType 
* unsigned short Index 
* TelSimPb2gData t pPbData 


6.33.2 Field Documentation 
6.33.2.1 TelSimPbFileType t TelSimPbRecordData t::StorageFileType 


Storage file type 


6.33.2.2 unsigned short TelSimPbRecordData t::Index 


Index of the record being read/updated. 


6.33.2.3 TelSimPb2gData t TelSimPbRecordData t::pPbData 


Phone book contact info. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.34 TelSimPbStorageInfo_t Struct Reference 


#include <TelSim.h> 


6.34.1 Detailed Description 


This data structure defines the phone book storage count information. 


Data Fields 


* TelSimPbFileType t StorageFileType 
* unsigned short TotalRecordCount 
* unsigned short UsedRecordCount 


6.34.2 Field Documentation 
6.34.2.1 TelSimPbFileType t TelSimPbStoragelInfo t::StorageFileType 


Storage file type 


6.34.2.2 unsigned short TelSimPbStoragelInfo t::TotalRecordCount 


Total record count 


6.34.2.3 unsigned short TelSimPbStorageInfo t::UsedRecordCount 


Used record count 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.35 TelSimPbUpdateResp_t Struct Reference 


#include <TelSim.h> 


6.35.1 Detailed Description 


This data structure gives the phone book update(add/edit/delete) response. 


Data Fields 


* TelSimPbAccessResult t PbAccessResult 
• TelSimPbStorageInfo t PbStorageInfo 
* unsigned short PbIndex 


6.35.2 Field Documentation 
6.35.2.1  TelSimPbAccessResult t TelSimPbUpdateResp t::PbAccessResult 


Indicates the result of phonebook update/read operation. 


6.35.2.2  TelSimPbStorageInfo t TelSimPbUpdateResp t::PbStorageInfo 


Indicates the total and used phonebook entries for the updated storage type (ADN/FDN, etc). 


6.35.2.3 unsigned short TelSimPbUpdateResp t::PbIndex 


Phone book record index that was updated/deleted. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.36 TelSimPinData t Struct Reference 


#include <TelSim.h> 


6.36.1 Detailed Description 


This structure contains information about pin data. 


Data Fields 


* TelSimPinType t PinType 
e char szPinCode [ТАРІ SIM PIN LENGTH- 1] 


6.36.2 Field Documentation 
6.36.2.1  TelSimPinType t TelSimPinData t::PinType 


Pin type 


6.36.2.2 char TelSimPinData t::szPinCode[|TAPI SIM PIN LENGTH-1] 


PIN code 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.37 TelSimPinInfo_t Struct Reference 


#include <TelSim.h> 


6.37.1 Detailed Description 


This data structure defines the data for the PIN Informtion. 


Data Fields 


* TelSimPinType t PinType 
* int RemainingAttempts 


6.37.2 Field Documentation 
6.37.2.1 TelSimPinType t TelSimPinInfo t::PinType 


Specifies the PIN or PUK type. 


6.37.2.2 int TelSimPinInfo t::RemainingAttempts 


Number of attempts remaining for PIN/PUK verification. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.38 TelSimReadFileData_t Struct Reference 


Шіпсіпде <TelSim.h> 


6.38.1 Detailed Description 


This structure contains all read SIM elementary file information. 


Data Fields 


• TelSimHileID t Fileld 
* unsigned short DataLen 
* unsigned char Data 


6.38.2 Field Documentation 
6.38.2.1 TelSimFileID t TelSimReadFileData t::FileId 


File Id 


6.38.2.2 unsigned short TelSimReadFileData t::DataLen 


Data Length 


6.38.2.3 unsigned char TelSimReadFileData t::Data 


SIM EF Data 


The documentation for this struct was generated from the following file: 


* TelSim.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


6.39 TelSimReadFileRequestData t Struct Reference 


253 


6.39 TelSimReadFileRequestData_t Struct Reference 


#include <TelSim.h> 


6.39.1 Detailed Description 


This data structure defines the data for the Read file result information. 


Data Fields 


TelSimFileID_t FileID 
TelSimFileType_t FileType 
unsigned long Offset 


unsigned long RecordIndex 


unsigned long RecordIndexFrom 


unsigned long RecordIndexTo 
TelSimRecordMode_t RecordMode 
unsigned long DataLength 


6.39.2 Field Documentation 
6.39.2.1 TelSimFileID_t TelSimReadFileRequestData_t::FileID 


sim file id to read 


6.39.2.2 TelSimFileType_t TelSimReadFileRequestData_t::FileType 


sim file type 


6.39.2.3 unsigned long TelSimReadFileRequestData_t::Offset 


Offset if read binary 


6.39.2.4 unsigned long TelSimReadFileRequestData_t::RecordIndex 


record index if read record 


6.39.2.5 unsigned long TelSimReadFileRequestData_t::RecordIndexFrom 


start index from 


6.39.2.6 unsigned long TelSimReadFileRequestData_t::RecordIndexTo 


end index to 
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6.39.2.7 TelSimRecordMode_t TelSimReadFileRequestData t::RecordMode 


record mode if read record 


6.39.2.8 unsigned long TelSimReadFileRequestData t::DataLength 


data length to read 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.40 TelSimServiceTable t Struct Reference 


#include <TelSim.h> 


6.40.1 Detailed Description 


This data structure defines the data for the Sst (SIM service table) information. 


Data Fields 


BOOL bPIN1DisableFunction 
BOOL bAdn 

BOOL bFdn 

BOOL bSms 

BOOL bAoc 

BOOL bCcp 

BOOL bPlmnSelector 

BOOL bRful 

BOOL bMsisdn 

BOOL bExtensionl 

BOOL bExtension2 

BOOL bSmsParams 

BOOL bind 

BOOL bCellBroadCastMsglId 
BOOL bGroupldLevell 

BOOL bGroupIdLevel2 

BOOL bSpn 

BOOL bSdn 

BOOL bExtension3 

BOOL bRfu2 

BOOL bVgcsGroupIdList 

BOOL bVbsGroupIDList 

BOOL bEnhancedMultilevelPrecedencePreemptionService 
BOOL bAutoAnswerForeMLPP 
BOOL bSmsCbdDataDownload 
BOOL bSmsPpDataDownload 
BOOL bMenuSelection 

BOOL bCallControl 

BOOL bProactiveSimCommand 
BOOL bCellBroadcastMsgIdRanges 
BOOL bBdn 

BOOL bExtension4 

BOOL bDePersonalizedControlKeys 
BOOL bCoOperativeNetworkList 
BOOL bSmsr 

BOOL bNetworkAlertIndInMS 
BOOL bMoSMSControl 

BOOL bGPRS 

BOOL bImage 
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BOOL bSolsa 

BOOL bUSSDSupportedInCallControl 

BOOL bRunAtCommand 

BOOL bUserControlledPLMNSelectorAccessTech 
BOOL bOperatorControlledPlmnSelectorAccessTech 
BOOL bHpImnSelectorAccessTech 

BOOL bCPBCCHInfo 

BOOL biInvestigationScan 

BOOL bExtenedCapaConfigParams 

BOOL bMexe 

BOOL bRplmnLastUsedAccessTech 


6.40.2 Field Documentation 
6.40.2.1 BOOL TelSimServiceTable_t::bPIN1DisableFunction 


PIN1 disable function 


6.40.2.2 BOOL TelSimServiceTable_t::bAdn 


abbreviated Dialing number 


6.40.23 BOOL TelSimServiceTable_t::bFdn 


fixed Dialing number 


6.40.2.4 BOOL TelSimServiceTable_t::bSms 


short message storage 


6.40.2.5 BOOL TelSimServiceTable_t::bAoc 


advice of charge 


6.40.2.6 BOOL TelSimServiceTable_t::bCcp 


capability configuration parameters 


6.40.27 BOOL TelSimServiceTable_t::bPlmnSelector 


plmn selector 


6.40.2.8 BOOL TelSimServiceTable_t::bRful 


rfu 
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6.40.2.9 BOOL TelSimServiceTable t::bMsisdn 


msisdn 


6.40.2.10 BOOL TelSimServiceTable_t::bExtension1 


extension | 


6.40.2.11 BOOL TelSimServiceTable_t::bExtension2 


extension2 


6.40.2.12 BOOL TelSimServiceTable_t::bSmsParams 


sms paramteres 


6.40.2.13 BOOL TelSimServiceTable_t::blnd 


last number dialled 


6.40.2.14 BOOL TelSimServiceTable_t::bCellBroadCastMsgId 


cell broadcast message identifier 


6.40.2.15 BOOL TelSimServiceTable_t::bGroupIdLevel1 


group identifier level 1 


6.40.2.16 BOOL TelSimServiceTable t::bGroupIdLevel2 


group identifier level 2 


6.40.2.17 BOOL TelSimServiceTable_t::bSpn 


service provider name 


6.40.2.18 BOOL TelSimServiceTable_t::bSdn 


service Dialing number 


6.40.2.19 BOOL TelSimServiceTable_t::bExtension3 


extension3 
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6.40.2.20 BOOL TelSimServiceTable t::bRfu2 


rfu 


6.40.2.21 BOOL TelSimServiceTable t::bVgcsGrouplIdList 


vgcs group identifier (EF-VGCS, EF-VGCSS) 


6.40.2.22 BOOL TelSimServiceTable t::bVbsGroupIDList 


vbs group identifier (EF-VBS, EF-VBSS) 


6.40.2.23 BOOL TelSimServiceTable t::bEnhancedMultilevelPrecedencePreemptionService 


enhanced multi-level precedence and pre-emption service 


6.40.2.24 BOOL TelSimServiceTable t::bAutoAnswerForeMLPP 


automatic answer fro eMLPP 


6.40.2.25 BOOL TelSimServiceTable t::bSmsCbdDataDownload 


data download via sms-cb 


6.40.2.26 BOOL TelSimServiceTable t::bSmsPpDataDownload 


data download via sms-pp 


6.40.2.27 BOOL TelSimServiceTable_t::bMenuSelection 


menu selection 


6.40.2.28 BOOL TelSimServiceTable t::bCallControl 


call control 


6.40.2.29 BOOL TelSimServiceTable t::bProactiveSimCommand 


proactive sim command 


6.40.2.30 BOOL TelSimServiceTable_t::bCellBroadcastMsgIdRanges 


cell broadcast message identifier ranges 
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6.40.2.31 BOOL TelSimServiceTable t::bBdn 


barred Dialing numbers 


6.40.2.32 BOOL TelSimServiceTable t::bExtension4 


extension 4 


6.40.2.33 BOOL TelSimServiceTable_t::bDePersonalizedControlKeys 


de-personalization control keys 


6.40.2.34 BOOL TelSimServiceTable_t::bCoOperativeNetworkList 


co-operative network list 


6.40.2.35 BOOL TelSimServiceTable_t::bSmsr 


short message status reports 


6.40.2.36 BOOL TelSimServiceTable_t::bNetworkAlertIndInMS 


network’s indication of alerting in the MS 


6.40.2.37 BOOL TelSimServiceTable_t::bMoSMSControl 


mobile-originated short message control by sim 


6.40.2.38 BOOL TelSimServiceTable t::bGPRS 


gprs 


6.40.2.39 BOOL TelSimServiceTable_t::bImage 


image 


6.40.2.40 BOOL TelSimServiceTable_t::bSolsa 


support of local service area 


6.40.2.41 BOOL TelSimServiceTable t::bUSSDSupportedInCallControl 


ussd string data object supported in call control 
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6.40.2.42 BOOL TelSimServiceTable t::bRunAtCommand 


RUN AT COMMAND command 


6.40.2.43 BOOL TelSimServiceTable_t::bUserControlledPLMNSelectorAccessTech 


user controlled PLMN selector with Access technology 


6.40.2.44 BOOL TelSimServiceTable t::bOperatorControlledPImnSelectorAccessTech 


operator controlled PLMN selector with Access technology 


6.40.2.45 BOOL TelSimServiceTable t::bHplmnSelectorAccessTech 


HPLMN selector with access technology 


6.40.2.46 BOOL TelSimServiceTable t::bCPBCCHInfo 


CPBCCH information 


6.40.2.47 BOOL TelSimServiceTable t::bInvestigationScan 


investigation scan 


6.40.2.48 BOOL TelSimServiceTable t::bExtenedCapaConfigParams 


extended capability configuration parameters 


6.40.2.49 BOOL TelSimServiceTable t::bMexe 


MExE 


6.40.2.50 BOOL TelSimServiceTable t::bRplmnLastUsedA ccess Tech 


RPLMN last used access technology 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.41 TelSimSstInfo_t Struct Reference 


#include <TelSim.h> 


6.41.1 Detailed Description 


This data structure defines the data for the Sim service table information. 


Data Fields 


* unsigned long SstLen 
* unsigned short SstData [TAPI SIM SST MAX LEN] 
* TelSimServiceTable t Sst 


6.41.2 Field Documentation 
6.41.2.1 unsigned long TelSimSstInfo t::SstLen 


SIM service table length 


6.41.2.2 unsigned short TelSimSstInfo t::SstData[TAPI SIM SST MAX LEN] 


SIM service table data 


6.41.2.3 TelSimServiceTable t TelSimSstInfo t::Sst 


This data structure defines the data for the Sst (SIM service table) information. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.42 TelSimStatusData t Struct Reference 


Шіпсіпде <TelSim.h> 


6.42.1 Detailed Description 


This data structure defines the SIM card status data. 


Data Fields 


TelSimCardStatus_t CardStatus 

TelSimPinStatus_t UpinStatus 

TelSimPinStatus_t Pin1 Status 

TelSimPinStatus_t Pin2Status 

TelSimCardType_t CardType 

unsigned short EccRecordCount 

TelSimEccData_t EccRecord 
TelSimLanguageInfo t LpInfo 

unsigned long IccidLen 

unsigned short Iccid [TAPI SIM ICCIDLENGTH] 


6.42.2 Field Documentation 
6.42.2.1 TelSimCardStatus t TelSimStatusData_t::CardStatus 


Provides the card status 


6.42.2.2 TelSimPinStatus t TelSimStatusData t::UpinStatus 


Universal PIN status 


6.42.2.3 TelSimPinStatus t TelSimStatusData_t::Pin1Status 


Provides the Pin 1 status 


6.42.2.4 TelSimPinStatus t TelSimStatusData t::Pin2Status 


Provides the Pin 2 status 


6.42.2.5 TelSimCardType t TelSimStatusData t::CardType 


Provides the SIM card type 


6.42.2.6 unsigned short TelSimStatusData t::EccRecordCount 


Provides the Emergency Call Code record count 
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6.42.27 TelSimEccData_t TelSimStatusData t::EccRecord 


Provides the Emergency call codes 


6.42.2.8  TelSimLanguagelnfo t TelSimStatusData t::LpInfo 


Provides the Language preference information 


6.42.2.9 unsigned long TelSimStatusData t::IccidLen 


Provides the Integrated Circuit Card id length 


6.42.2.10 | unsigned short TelSimStatusData t::Iccid|(TAPI SIM ICCIDLENGTH] 


Provides the Integrated Circuit Card id 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.43 TelSimUpdateFileRequestData t Struct Reference 


#include <TelSim.h> 


6.43.1 Detailed Description 


This structure contains the information required to update elementary files in SIM. 


Data Fields 


TelSimFileID t Fileld 
TelSimFileType t FileType 


unsigned long Offset 


unsigned long RecordIndex 
TelSimRecordMode t RecordMode 


unsigned long DataLen 


unsigned char ж szData 


6.43.2 Field Documentation 
6.43.2.1 TelSimFileID_t TelSimUpdateFileRequestData_t::FileId 


sim file id to update 


6.43.2.2 TelSimFileType t TelSimUpdateFileRequestData t::FileType 


sim file type 


6.43.2.3 unsigned long TelSimUpdateFileRequestData t::Offset 


Offset, if update for a binary file 


6.43.2.4 unsigned long TelSimUpdateFileRequestData t::RecordIndex 


Record index, if update is for record type file 


6.43.2.5  TelSimRecordMode t TelSimUpdateFileRequestData t::RecordMode 


Record index, if update is for record type file 


6.43.2.6 unsigned long TelSimUpdateFileRequestData t::DataLen 


szData length to update 
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6.43.2.7 unsigned char» TelSimUpdateFileRequestData t::szData 


SIM EF Data 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.44 TelSimUstInfo_t Struct Reference 


#include <TelSim.h> 


6.44.1 Detailed Description 


This data structure defines the data for the USim service table information. 


Data Fields 


* unsigned long UsimSstLen 
* unsigned short UstData [TAPI SIM SST MAX LEN] 
* TelUSimServiceTable t UsimSst 


6.44.2 Field Documentation 
6.44.2.1 unsigned long TelSimUstInfo t::UsimSstLen 


USIM service table length 


6.44.2.2 unsigned short TelSimUstInfo t::UstData|(TAPI SIM SST MAX LEN] 


USIM service table data - Complete service table from sim. 


6.44.2.3 TelUSimServiceTable t TelSimUstInfo t::UsimSst 


This data structure defines the data for the UST (USIM service table) information. 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.45 TelSmsAddressInfo t Struct Reference 


#include <TelNetText.h> 


6.45.1 Detailed Description 


This structure defines the properties of a dialing number Type of Number, Numbering Plan Indicator, length 
and the actual number. 


Data Fields 


* unsigned int DialNumLen 

* TelSimTypeOfNum t Ton 

• TelSimNumberingPlanlIdentity t Npi 

e unsigned char szDiallingNum [ТАРІ SIM. SMSP ADDRESS LEN-«1] 


6.45.2 Field Documentation 
6.45.2.1 unsigned int TelSmsAddressInfo_t::DialNumLen 


length of address 


6.45.2.2 TelSimTypeOfNum t TelSmsAddressInfo_t::Ton 


Type of number 


6.45.2.3 TelSimNumberingPlanIdentity t TelSmsAddressInfo_t::Npi 


Numbering plan identification 


6.45.2.4 unsigned char Tel8msA ddressInfo t::szDiallingNum[TAPI SIM SMSP ADDRESS - 
LEN+1] 


destination address 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.46 TelSmsCbConfig t Struct Reference 


#include <TelNetText.h> 


6.46.1 Detailed Description 


This structure defines the different parameters of CB configuration 


Data Fields 


* BOOL bCBEnabled 

* unsigned char SelectedId 

• int MsgIdCount 

e unsigned short MsgIDs [ТАРІ NETTEXT GSM. SMS CBMI LIST SIZE MAX] 


6.46.2 Field Documentation 
6.46.21 BOOL TelSmsCbConfig_t::bCBEnabled 
CB service state. If cb enabled is true then cell broadcast service will be enabled and underlying modem 


will enable CB Channel to receiving CB messages. Otherwise CB service will be disabled, underlying 
modem will deactivate the CB channel. (enabled/disabled) 


6.46.2.2 unsigned char TelSmsCbConfig_t::SelectedId 


CBMI Identifier selected (all or some) 


6.46.2.3 int TelSmsCbConfig_t::MsgIdCount 


CB message ID count 


6.46.2.4 unsigned short TelSmsCbConfig_t::MsgIDs[TAPI NETTEXT_GSM_SMS_CBMI_- 
LIST SIZE MAX] 


CB message ID information 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.47 TelSmsCbMsg t Struct Reference 


#include <TelNetText.h> 


6.47.1 Detailed Description 


This structure defines a cell broadcast message. 


Data Fields 


e TelSmsCbMsgType_t CbMsgType 
* unsigned short Length 
e char szMsgData [ТАРІ NETTEXT CB PAGE SIZE MAX+1] 


6.47.2 Field Documentation 
6.47.21  Tel8msCbMsgType t Tel8msCbMsg t:: CbMsgType 


Cell Broadcast message type 


6.47.2.2 unsigned short Tel8msCbMsg t::Length 


Size of array szMsgData (which is actual TPDU message) 


6.47.2.3 char Tel$msCbMsg t::szMsgData[TAPI NETTEXT CB PAGE SIZE МАХ+1] 


Cell broadcast message data[Refer 3GPP TS 23.041 9.4.1] 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.48 TelSmsData t Struct Reference 


#include <TelNetText.h> 


6.48.1 Detailed Description 


This structure defines the data Related to SimIndex,Message Status and SMS Data Stored. 


Data Fields 


* signed short SimIndex 
* TelSmsMsgStatus_t MsgStatus 
* TelSmsDatapackageInfo_t SmsData 


6.48.2 Field Documentation 
6.48.2.1 signed short TelSmsData_t::SimIndex 


Index where SMS is stored. If index is invalid (-1), then it means the message is not stored in SIM. 


6.48.2.2 Tel$8msMsgStatus t TelSmsData_t::MsgStatus 


Message status. If index is invalid, Msg status shall be ignored. 


6.48.2.3 TelSmsDatapackageInfo_t TelSmsData_t::SmsData 


SMS message 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.49 TelSmsDatapackageInfo t Struct Reference 


#include <TelNetText.h> 


6.49.1 Detailed Description 


This structure defines the fields related to an Sms like sim index, TPDU and length 


Data Fields 
e char ж pSCA 
* int MsgLength 
e char szData [ТАРІ NETTEXT SMDATA SIZE МАХ-11 
6.49.2 Field Documentation 
6.49.2.1 char» TelSmsDatapackagelInfo_t::pSCA 
Service Centre address - an optional parameter. If this parameter is not present, then this field will be Null.If 


present, the valid service centre address information is filled as per TelSmsAddressInfo_t and provided as 
char 


6.49.2.2 int TelSmsDatapackageInfo_t::MsgLength 


Size of array szData (which is actual TPDU message) 


6.49.2.3 char TelSmsDatapackageInfo_t::szData[TAPI_NETTEXT_SMDATA_SIZE_MAX+1] 


SMS TPDU message 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.50 TelSmsParams t Struct Reference 


#include <TelNetText.h> 


6.50.1 Detailed Description 


This structure defines different fields involved in setting the parameters of a particular sms in EFsmsp. 


Data Fields 


unsigned char RecordIndex 


unsigned char RecordLen 


unsigned long AlphaldLen 

char szAlphald [TAPI_SIM_SMSP_ALPHA_ID_LEN_MAX+1] 
BYTE ParamIndicator 

TelSmsAddressInfo_t TpDestAddr 

TelSmsAddressInfo t TpSvcCntrAddr 

unsigned short TpProtocolId 


unsigned short TpDataCodingScheme 


unsigned short Tp ValidityPeriod 


6.50.2 Field Documentation 
6.50.2.1 unsigned char TelSmsParams_t::RecordIndex 


Index 


6.50.2.2 unsigned char TelSmsParams_t::RecordLen 


SMS Parameter Record length 


6.50.2.3 unsigned long Tel8msParams t::AlphaldLen 


Alpha id length 


6.50.2.4 char Tel$msParams t::szAlphald[TAPI SIM SMSP ALPHA ID LEN МАХ-11 


Alpha id .It is a unique identifier for each row/record in EFsmsp 


6.50.2.5 BYTE TelSmsParams_t::ParamIndicator 


SMS parameter indicator is a 1 byte value. Each bit in this value indicates the presence/absence of the 
sms header parameters.If the parameter is present the corresponding bit value is set to O.If the parameter is 
absent then it is set as 1.Refer 3GPP TS 31.02 :4.4.23 
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6.50.2.6 TelSmsAddressInfo_t TelSmsParams_t::TpDestAddr 


TP-destination address (TP-DA) 


6.50.2.7 TelSmsAddressInfo_t TelSmsParams_t::TpSvcCntrAddr 


TP-service center address 


6.50.2.8 unsigned short TelSmsParams_t::TpProtocolld 


TP-protocol Id 


6.50.2.9 unsigned short TelSmsParams_t::TpDataCodingScheme 


TP-data coding scheme 


6.50.2.10 unsigned short TelSmsParams_t::TpValidityPeriod 


TP-validity period 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.51 TelSmsStoredMsgCountInfo t Struct Reference 


#include <TelNetText.h> 


6.51.1 Detailed Description 


This structure defines the different parameters that are related to the message count in a particular mem- 
ory(Phone/SIM) 


Data Fields 


* unsigned int TotalCount 
* int UsedCount 
* int IndexList [TAPI МЕТТЕХТ (55М SMS MSG NUM MAX] 


6.51.2 Field Documentation 
6.51.2.1 unsigned int TelSmsStoredMsgCountInfo_t::TotalCount 


Total count of messages stored in SIM 


6.51.2.2 int Tel8msStoredMsgCountInfo t::UsedCount 


Stored message count in SIM in SIM 


6.51.2.3 int Tel8msStoredMsgCountInfo t::IndexList[TAPI NETTEXT GSM SMS MSG - 
NUM MAX] 


Message index list stored in SIM. And the maximum size of this array can be of totalCount.This array 
contains the list of index values in which the messages are stored.i.e. index list[totalcount] = [2,3] denotes 
that indexs 2 and 3 are stored(valid) and others not(empty). 


The documentation for this struct was generated from the following file: 


* TelNetText.h 
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6.52 TelSsCallBarringInfo_t Struct Reference 


#include <TelSs.h> 


6.52.1 Detailed Description 


This structure defines the different parameters related to call barring. 


Data Fields 


* TelSsCallBarOperationMode t Mode 

* TelSsCallBarType t Type 

* TelSsCallType t CallType 

* char szPassword [TAPI 55 GSM BARR PW LEN MAX] 


6.52.2 Field Documentation 
6.52.21  TelSsCallBarOperationMode t TelSsCallBarringInfo t::Mode 


Barring mode 


6.52.2.2 TelSsCallBarType t TelSsCallBarringInfo t::Type 


Barring type 


6.52.2.3 TelSsCallType_t TelSsCallBarringInfo_t::CallType 


Call type 


6.52.2.4 char TelSsCallBarringInfo_t::szPassword[TAPI_SS_GSM_BARR_PW_LEN_MAX] 


password 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.53 TelSsCallBarringRecord_t Struct Reference 


#include <TelSs.h> 


6.53.1 Detailed Description 


This structure defines the values for ss call barring record 


Data Fields 


* TelSsStatus t Status 
* TelSsCallBarType t Flavour 
* TelSsTeleService t TeleCommService 


6.53.2 Field Documentation 
6.53.2.1 'TelSsStatus t TelSsCallBarringRecord t::Status 


Ss status 


6.53.2.2 TelSsCallBarType t TelSsCallBarringRecord t::Flavour 


Call barring types providing various barring conditions on that basis call be barred 


6.53.2.3  TelSsTeleService t TelSsCallBarringRecord t::TeleCommService 


Tele service 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.54 TelSsCallWaitingRecord t Struct Reference 


#include <TelSs.h> 


6.54.1 Detailed Description 


This structure defines the values for ss call waiting record 


Data Fields 


* TelSsStatus t Status 
* TelSsTeleService t TeleCommService 


6.54.2 Field Documentation 
6.54.2.1 TelSsStatus_t TelSsCallWaitingRecord_t::Status 


SS status 


6.54.2.2 TelSsTeleService t TelSsCall WaitingRecord_t::TeleCommService 


Tele service 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.55 TelSsCapabilityInfo_t Struct Reference 


#include <TelSs.h> 


6.55.1 Detailed Description 


This structure defines the various parameters in a capability info type 


Data Fields 


* BOOL bCFSupported 

* BOOL bCBSupported 

* BOOL bMPTYSupported 

* BOOL bCWSupported 

* BOOL bCallHoldSupported 
* BOOL bECTSupported 


6.55.2 Field Documentation 
6.55.21 BOOL TelSsCapabilityInfo t::bCFSupported 


TRUE will indicate call forwarding supported, FALSE otherwise. 


6.55.2.2 BOOL TelSsCapabilityInfo t::bCBSupported 


TRUE will indicate call barring supported, FALSE otherwise. 


6.55.2.3 BOOL TelSsCapabilityInfo t::bMPTYSupported 


TRUE will indicate Multi Party call handling supported, FALSE otherwise 


6.55.2.4 BOOL TelSsCapabilityInfo t::bCWSupported 


TRUE will indicate call waiting supported, FALSE otherwise 


6.55.25 BOOL TelSsCapabilityInfo t::bCallHoldSupported 


TRUE will indicate call hold supported, FALSE otherwise. 


6.55.2.6 BOOL TelSsCapabilityInfo t::bECTSupported 


TRUE will indicate explicit call transfer supported, FALSE otherwise. 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.56 TelSsCliRecord t Struct Reference 


#include <TelSs.h> 


6.56.1 Detailed Description 


This structure defines the values for Calling line identity service 


Data Fields 


* TelSsLineldentificationType_t IdentificationType 
* TelSsCliStatus_t CliStatus 


6.56.2 Field Documentation 
6.56.2.1 'TelSsLineIdentificationType t TelSsCliRecord t::IdentificationType 


Various line identification types 


6.56.2.2 TelSsCliStatus t TelSsCliRecord t::CliStatus 


Line indentification status from network 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.57 TelSsForwardInfo_t Struct Reference 


#include <TelSs.h> 


6.57.1 Detailed Description 


This structure defines the different parameters related to forward info. 


Data Fields 


* TelSsForwardMode t Mode 

* TelSsForwardType t Type 

* TelSsForwardWhen t Condition 

• char szPhoneNumber [ТАРІ CALL DIALDIGIT LEN MAX] 


6.57.2 Field Documentation 
6.57.21  TelSsForwardMode t TelSsForwardInfo t::Mode 


Forward Mode 


6.57.2.2  TelSsForwardType t TelSsForwardInfo t::Type 


Forward Type 


6.57.2.3 TelSsForwardWhen t TelSsForwardInfo_t::Condition 


Forward Condition 


6.57.2.4 char TelSsForwardInfo t::szPhoneNumber(TAPI CALL DIALDIGIT LEN MAX] 


Phone Number 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.58 TelSsForwardRecord t Struct Reference 


#include <TelSs.h> 


6.58.1 Detailed Description 


This structure defines the values for ss call forwarding record 


Data Fields 


* TelSsStatus t Status 

* TelSsForwardWhen t ForwardCondition 

* TelSsTeleService t TeleCommService 

* BOOL bCallForwardingNumberPresent 

* unsigned char szCallForwardingNumber [ТАРІ САШ, DIALDIGIT LEN MAX] 


6.58.2 Field Documentation 
6.58.2.1  TelSsStatus t TelSsForwardRecord t::Status 


Call forwarding SS status 


6.58.2.2 TelSsForwardWhen t TelSsForwardRecord t::ForwardCondition 


Call forward types providing various conditions when call can be forwarded 


6.58.2.3  TelSsTeleService t TelSsForwardRecord t::TeleCommService 


Tele service type 


6.58.2.4 BOOL TelSsForwardRecord t::bCallForwardingNumberPresent 


Call forwarding number present or not 


6.58.2.5 unsigned char TelSsForwardRecord t::szCallForwardingNumber[TAPI CALL - 
DIALDIGIT LEN MAX] 


forwarded number.[Null Terminated string] 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.59 TelSsInfo_t Struct Reference 


#include <TelSs.h> 


6.59.1 Detailed Description 


related all kind of SS information 


Data Fields 


* TelSsType t SsType 

* TelSsStatus t SsStatus 

* UINT NumberOfRecords 

* TelSsRecord t SsRecord 

* TelSsTeleService t SsTeleserviceType 


6.59.2 Field Documentation 
6.59.2.1  TelSsType t TelSsInfo t::SsType 


Supplementary service type 


6.59.2.2 TelSsStatus t TelSsInfo t::SsStatus 


SS status information 


6.59.2.3 ОМТ TelSsInfo_t::NumberOfRecords 


Number of records present for Call Barring / Call forwarding / Call waiting. In case of any error, this 


parameter value will be set to zero. 


6.59.2.4  TelSsRecord t TelSsInfo t::SsRecord 


SS record (Union of Call Barring / Call Forwarding/Call waiting / line identification information). This 


structure can be Null when number. of records parameter is zero. 


6.59.2.5 "TelSsTeleService t TelSsInfo t::SsTeleserviceType 


Tele service type 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.60 TelSsRecord t Union Reference 


#include <TelSs.h> 


6.60.1 Detailed Description 


This structure defines the parameters for SS record type 


Data Fields 


* TelSsCallWaitingRecord_t WaitingRecord 
* TelSsCallBarringRecord t BarringRecord 
* TelSsCliRecord t CliRecord 

* TelSsForwardRecord t ForwardingRecord 


6.60.2 Field Documentation 
6.60.2.1 TelSsCallWaitingRecord_t TelSsRecord_t::WaitingRecord 


Call waiting information 


6.60.2.2 TelSsCallBarringRecord t TelSsRecord t::BarringRecord 


Call barring information 


6.60.2.3 TelSsCliRecord_t TelSsRecord t::CliRecord 


Line identification information 


6.60.2.4 TelSsForwardRecord_t TelSsRecord t::ForwardingRecord 


Call forward record information 


The documentation for this union was generated from the following file: 


* TelSs.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 
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6.61 TelSsUssdMsgInfo_t Struct Reference 


#include <TelSs.h> 


6.61.1 Detailed Description 


This structure defines the values for USSD request type. 


Data Fields 


* TelSsUssdIndType t IndType 

e UINTS8 Dcs 

* int UssdStringLength 

* char szUssdString [TAPI SS USSD DATA SIZE MAX] 


6.61.2 Field Documentation 
6.61.2.1  TelSsUssdIndType t TelSsUssdMsgInfo t::Ind Type 


USSD Indication type (This field is used in case of sending USSD Response only) 


6.61.2.2 UINTS TelSsUssdMsglInfo t::Dcs 


Data coding scheme value as per 3GPP TS 23.038 


6.61.2.3 int TelSsUssdMsgInfo t::UssdStringLength 


USSD data length 


6.61.2.4 char TelSsUssdMsglInfo t::szUssdString[ TAPI SS USSD DATA SIZE MAX] 


USSD data 


The documentation for this struct was generated from the following file: 


* TelSs.h 
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6.62 TelTapiErrorInfo_t Struct Reference 


#include «TelUtility.h» 


6.62.1 Detailed Description 


This structure holds information like length and actual error data. 


Data Fields 


* unsigned int Length 
e void x pErrorData 


6.62.2 Field Documentation 
6.62.2.1 unsigned int TelTapiErrorInfo_t::Length 


Length of error data 


6.62.2.2 void» TelTapiErrorInfo t::pErrorData 


Error information exchanged between OEM and application(Not Null terminated string). For Debug- 
ging/Display purpose on screen. 


The documentation for this struct was generated from the following file: 


* TelUtility.h 
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6.63 TelTapiEvent t Struct Reference 


#include <TapiCommon.h> 


6.63.1 Detailed Description 


This structure defines the Telephony Event 


Data Fields 


* TelTapiEventClass t EventClass 
* TelTapiEventType t EventType 
* int RequestId 

* int Status 

e void ж pData 


6.63.2 Field Documentation 
6.63.2.1 ' TelTapiEventClass t TelTapiEvent t::EventClass 


Event type 


6.63.2.2 TelTapiEventType t TelTapiEvent t::EventType 


Event type 


6.63.2.3 int TelTapiEvent t::RequestId 


This parameter is applicable only for Asynchronous solicited responses. The request id for a service request 
is sent back in the asynchronous response. For unsolicited indications, request id will be -1 


6.63.2.4 int TelTapiEvent t::Status 


This parameter is applicable only for Asynchronous solicited responses. This status parameter informs the 
actual result of Asynchronous response. For unsolicited indications, status will be -1 


6.63.2.5 void» TelTapiEvent t::pData 


Event Data - Based on Event type response/indications. Event data information is captured in each API 
Section 


The documentation for this struct was generated from the following file: 


* TapiCommon.h 
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6.64 TelTapiTunnelInfo_t Struct Reference 


#include «TelUtility.h» 


6.64.1 Detailed Description 


This structure holds information like length and actual tunneling data. 


Data Fields 


* unsigned int TunnelDataLen 
e void x pTunnelData 


6.64.2 Field Documentation 
6.64.2.1 unsigned int TelTapiTunnelInfo t::TunnelDataLen 


Length of tunnel data 


6.64.2.2 void» TelTapiTunnelInfo t::pTunnelData 


Tunneling information exchanged between OEM and application(Not Null terminated string) 


The documentation for this struct was generated from the following file: 


* TelUtility.h 
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6.65 TelTapiVersionInfo_t Struct Reference 


#include «TelUtility.h» 


6.65.1 Detailed Description 


This structure holds Telephony version information. 


Data Fields 


e int Major Version 
* int MinorVersion 


6.65.2 Field Documentation 
6.65.2.1 int TelTapiVersionInfo_t::MajorVersion 


Major Telephony version 


6.65.2.2 int TelTapiVersionInfo_t::MinorVersion 


Minor Telephony version 


The documentation for this struct was generated from the following file: 


* TelUtility.h 
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6.66 TelUsimEccInfo t Struct Reference 


#include <TelSim.h> 


6.66.1 Detailed Description 


This data structure defines the data for the USim emergency call code information. 


Data Fields 


* BOOL bUsed 

* char szEcc [TAPI SIM ECC CODE LEN] 

* unsigned short EccLen 

* char szEccAlphaldentifier [TAPI SIM ECC ALPHA STRING LEN MAX] 
• TelSimEccEmergencyServiceInfo t EccEmergencyServiceInfo 


6.66.2 Field Documentation 
6.66.2.1 BOOL TelUsimEccInfo t::bUsed 


Userd or not 


6.66.2.2 char TelUsimEccInfo t::szEcc[TAPI SIM ECC CODE LEN] 


Emergency Call Code info-ECC is coded in BCD format. Unused bytes is set to OxFF. 


6.66.2.3 unsigned short TelUsimEccInfo t::EccLen 


Ecc length 


6.66.2.4 char TelUsimEccInfo t::szEccAlphaldentifier[TAPI SIM ECC ALPHA STRING - 
LEN MAX] 


Alphabet identifer 


6.66.2.5 TelSimEccEmergencyServiceInfo_t TelUsimEccInfo t::EccEmergencyServiceInfo 


ECC emergency service information 


The documentation for this struct was generated from the following file: 


* TelSim.h 
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6.67 TelUSimServiceTable t Struct Reference 


#include <TelSim.h> 


6.67.1 Detailed Description 


This data structure defines the data for the UST (USIM service table) information. 


Data Fields 


BOOL bLocalPhoneBook 

BOOL bFdn 

BOOL bExtension2 

BOOL bSdn 

BOOL bExtension3 

BOOL bBdn 

BOOL bExtension4 

BOOL bOCIOCT 

BOOL blcilct 

BOOL bSms 

BOOL bSmsr 

BOOL bSMSP 

BOOL bAoc 

BOOL bCcp 

BOOL bCellBroadcastMsgId 
BOOL bCellBroadcastMsgIdRanges 
BOOL bGroupldLevell 

BOOL bGroupIdLevel2 

BOOL bSpn 

BOOL bUserControlledPLMNSelectorAccessTech 
BOOL bMsisdn 

BOOL bImage 

BOOL bSolsa 

BOOL bEnhancedMultilevelPrecedencePreemptionService 
BOOL bAutoAnswerForeMLPP 
BOOL bRful 

BOOL bGsmAccess 

BOOL bSmsPpDataDownload 
BOOL bSmsCbdDataDownload 
BOOL bUsimCallControl 

BOOL bUsimMoSmsControl 
BOOL bRunAtCommand 

BOOL bShallBeSetToOne 

BOOL bEnabledServiceTable 
BOOL bAcl 

BOOL bDePersonalizedControlKeys 
BOOL bCoOperativeNetworkList 
BOOL bGsmSecurityContext 
BOOL bCpbcchilnformation 
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BOOL blInvestigationScan 
BOOL bMexe 


BOOL bOperatorControlledPlmnSelectorAccessTech 


BOOL bHpImnSelectorAccessTech 
BOOL bExtension5 

BOOL bPlmnNetworkName 

BOOL bOperatorPlmnList 

BOOL bMailBoxDiallingNumbers 
BOOL bMsgWaitingIndStatus 

BOOL bCallForwardingIndicationStatus 
BOOL bRplmnLastUsedAccessTech 
BOOL bServiceProviderDisplayInfo 
BOOL bMms 

BOOL bExtension8 

BOOL bUsimGpsCallControl 

BOOL bMmsUserConnectivityParameters 
BOOL bNia 

BOOL bVgcslIdList 

BOOL bVbsGroupld 


6.67.2 Field Documentation 


6.67.21 BOOL TelUSimServiceTable_t:: 


local phone book 


6.67.2. BOOL TelUSimServiceTable_t::bFdn 


fixed Dialing number 


6.67.2.3 BOOL TelUSimServiceTable t:: 


extension 2 


6.67.2.4 BOOL TelUSimServiceTable_t::bSdn 


service Dialing number 


6.67.2.5 BOOL TelUSimServiceTable 6: 


extension 3 


6.67.2.6 BOOL TelUSimServiceTable t:: 


barred Dialing numbers 


bLocalPhoneBook 


bExtension2 


bExtension3 


bBdn 
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6.67.2.7 BOOL TelUSimServiceTable t::bExtension4 


extension 4 


6.67.2.8 BOOL TelUSimServiceTable t::bOCIOCT 


outgoing call information 


6.67.2.9 BOOL TelUSimServiceTable t::bIcilct 


incoming call information 


6.67.2.10 BOOL TelUSimServiceTable t::bSms 


short message storage 


6.67.2.11 BOOL TelUSimServiceTable t::bSmsr 


short message status reports 


6.67.2.12 BOOL TelUSimServiceTable t::bSMSP 


short message service parameters 


6.67.2.13 BOOL TelUSimServiceTable t::bAoc 


advice of charage 


6.67.2.14 BOOL TelUSimServiceTable t::bCcp 


capability config parameters 


6.67.2.15 BOOL TelUSimServiceTable t::bCellBroadcastMsglId 


cell broadcast message identifier 


6.67.2.16 BOOL TelUSimServiceTable_t::bCellBroadcastMsgIdRanges 


cell broadcast message identifier randges 


6.67.2.17 BOOL TelUSimServiceTable_t::bGroupIdLevel1 


group identifier level 1 
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6.67.2.18 BOOL TelUSimServiceTable_t::bGroupIdLevel2 


group identifier level 2 


6.67.2.19 BOOL TelUSimServiceTable_t::bSpn 


service provide name 


6.67.2.20 BOOL TelUSimServiceTable_t::bUserControlledPLMNSelectorAccessTech 


user controlled plmn selector with access technology 


6.67.2.21 BOOL TelUSimServiceTable_t::bMsisdn 


msisdn 


6.67.2.22 BOOL TelUSimServiceTable_t::bImage 


image 


6.67.2.23 BOOL TelUSimServiceTable_t::bSolsa 


Solsa 


6.67.2.24 BOOL TelUSimServiceTable_t::bEnhancedMultilevelPrecedencePreemptionService 


enhanced multi-level precedence and pre-emption service 


6.67.2.25 BOOL TelUSimServiceTable_t::bAutoAnswerForeMLPP 


automatic answer fro eMLPP 


6.67.2.26 BOOL TelUSimServiceTable_t::bRful 


Rful 


6.67.2.7 BOOL TelUSimServiceTable_t::bGsmAccess 


gsm access 


6.67.2.28 BOOL TelUSimServiceTable_t::bSmsPpDataDownload 


data download via sms-pp 
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6.67.2.29 BOOL TelUSimServiceTable t:: 


data download via sms-cb 


6.67.2.30 BOOL TelUSimServiceTable t:: 


usim call control 


6.67.2.34 BOOL TelUSimServiceTable t:: 


mo-sms control by usim 


6.67.2.32 BOOL TelUSimServiceTable t:: 


RUN AT COMMAND command 


6.67.2.33 BOOL TelUSimServiceTable t:: 


shall be set to 1 


6.67.2.34 BOOL TelUSimServiceTable t:: 


enabled service table 


6.67.2.35 BOOL TelUSimServiceTable t:: 


APN control list 


6.67.2.36 BOOL TelUSimServiceTable t:: 


de-personalization control keys 


6.67.2.37 BOOL TelUSimServiceTable_t:: 


co-operative network list 


6.67.2.38 BOOL TelUSimServiceTable_t:: 


gsm security context 


6.67.2.39 BOOL TelUSimServiceTable_t:: 


cpbcch information 


bSmsCbdDataDownload 


bUsimCallControl 


bUsimMoSmsControl 


bRunAtCommand 


bShallBeSetToOne 


bEnabledServiceTable 


bAcl 


bDePersonalizedControlKeys 


bCoOperativeNetworkList 


bGsmSecurityContext 


bCpbcchilnformation 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


6.67 TelUSimServiceTable t Struct Reference 


295 


6.67.2.40 BOOL TelUSimServiceTable t::bInvestigationScan 


investigation scan 


6.67.2.41 BOOL TelUSimServiceTable t::bMexe 


mexe 


6.67.2.42 BOOL TelUSimServiceTable t::bOperatorControlledPImnSelectorA ccessTech 


Operator controlled PLMN selector with Access Technology 


6.67.2.43 BOOL TelUSimServiceTable_t::bHplmnSelectorAccessTech 


HPLMN selector with access technology 


6.67.2.44 BOOL TelUSimServiceTable t::bExtension5 


extension 5 


6.67.2.45 BOOL TelUSimServiceTable_t::bPlmnNetworkName 


plmn network name 


6.67.2.46 BOOL TelUSimServiceTable t::bOperatorPImnL ist 


operator plmn list 


6.67.2.47 BOOL TelUSimServiceTable t::bMailBoxDiallingNumbers 


mailbox Dialing numbers 


6.67.2.48 BOOL TelUSimServiceTable t::bMsgWaitingIndStatus 


message waiting indication status 


6.67.2.49 BOOL TelUSimServiceTable t::bCallForwardingIndicationStatus 


call forwarding indication status 


6.67.2.50 BOOL TelUSimServiceTable t::bRplmnLastUsedAccessTech 


RPLMN last used access technology 
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6.67.2.51 BOOL TelUSimServiceTable t::bServiceProviderDisplayInfo 


service provider display information 


6.67.2.52 BOOL TelUSimServiceTable t::bMms 


multimedia messaging service 


6.67.2.53 BOOL TelUSimServiceTable t::bExtension8 


extension 8 


6.67.2.54 BOOL TelUSimServiceTable_t::bUsimGpsCallControl 


call control on gprs by usim 


6.67.2.55 BOOL TelUSimServiceTable t::bMmsUserConnectivityParameters 


mms user connectivity parameters 


6.67.2.56 BOOL TelUSimServiceTable_t::bNia 


Network’s indication of alerting in the MS (NIA) 


6.67.2.57 BOOL TelUSimServiceTable t::bVgcsIdList 


VGCS Group Identifier List (EFVGCS and EFVGCSS) 


6.67.2.58 BOOL TelUSimServiceTable_t::bVbsGroupId 


VBS Group Identifier List (EFVBS and EFVBSS) 


The documentation for this struct was generated from the following file: 


* TelSim.h 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


Chapter 7 


File Documentation 


7.1 ComponentOverview.h File Reference 


7.1.4 Detailed Description 


Component Programming Interface Overview Header Template for Doxygen. 


This file contains configuration information for documentation generation; it does not contain any API- 
specific information. 
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7.2 ITapiCall.h File Reference 


7.2.1 Detailed Description 


This file serves as a "C" header file defines functions for Tapi Call Services. 
It contains a sample set of function prototypes that would be required by applications. 


Note: Call related supplementary services are dependent on Operator/Market/Vendor. If any of the Sup- 
plementary Service 


is not supported in underlying telephony provider due to the dependencies, then Call Related SS APIs may 
return 


an error TAPI API NOT SUPPORTED. 


#include "ITapiSs.h" 


#include "TapiCommon.h" 


#include "TelCall.h" 


Functions 


e TapiResult t TelTapiCallSetup (const TelCallSetupParams t *pParams, unsigned int «pCallHandle, 
int «pRequestId) 


This function originates MO call setup. This is an asynchronous function. The function completes immedi- 
ately and call setup proceeds in background. 


e TapiResult t TelTapiCallAnswer (unsigned int CallHandle, TelCallAnswerType t AnsType, int *p- 
RequestId) 


This function is used to answer the incoming call by accepting or rejecting the call. 


e TapiResult t TelTapiCallRelease (unsigned int CallHandle, int pRequestId) 


This function releases the call identified by Call Handle irrespective of call is hold or active state. 


е TapiResult t TelTapiCallReleaseAll (int »pRequestId) 


This function releases the all the calls irrespective of the call is hold or active state. Due to this API request, 
lower layers will release the call and END Indication Event will be sent to all the Applications. 


• TapiResult t TelTapiCallSendDTMF (const char *pDtmfString, int «pRequestId) 


This function sends one or more DTMF digits during the call. 


e TapiResult t TelTapiCallRetrieve (unsigned int CallHandle, int *pRequestld) 


This function retrieves the held call. The call identified by Call Handle must be in held state. 


e TapiResult t TelTapiCallHold (unsigned int CallHandle, int *pRequestId) 


This function puts the given call on hold. The call identified by Call Handle should be in active state. 


e TapiResult t Tel TapiCallJoin (unsigned int CallHandlel, unsigned int CallHandle2, int «pRequest- 
Id) 


This function joins the given two calls (one call in active conversation state and other call in held state) into 
conference. 
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e TapiResult t TelTapiCallSplit (unsigned int CallHandle, int «pRequestlId) 


This function triggers to splits a private call from multiparty call. This API allows creating a private 
communication with one of remote parties in a multiparty session. TAPI client application has to pass the 
call handle which needs to split from the multiparty call. 


e TapiResult t TelTapiCallExplicitTransfer (unsigned int CallHandle, int *pRequestId) 


This function triggers to do an explicit call transfer by connecting the two parties where in one party being 
active (active state) and another party being held (held state). 


e TapiResult t TelTapiCallGetStatus (unsigned int CallHandle, TelCallStatus t *pCallStatus) 


This function gets status for the current call identified by Call Handle whenever application wants the call 
status. Call handle must be valid. 


e TapiResult t TelTapiCallGetDuration (unsigned int CallHandle, unsigned int «pDurationInSecs) 


This function gets duration of the given call. This is a synchronous function. Duration is accounted from 
the moment the connection is established, i.e. call goes into active state for first time. 


e TapiResult t TelTapiCallGetConferenceList (unsigned int CallHandle, unsigned int *pCallList, int 
*pNoOfCalls) 


This is a synchronous function returns all call handles within the given conference call. 
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7.3  ITapiNetText.h File Reference 


7.3.1 Detailed Description 


This file serves as a "C" header file defines functions for Tapi NetText Services. 
It contains a sample set of function prototypes that would be required by applications. 


Telephony provides SMS TPDU interface as defined by 3GPP TS 23.040 Rel 5 version for sending /receiv- 
ing of SMS PDUs 


directly from/to SMS Plug-in (Messaging Framework). Telephony provides various APIs to 
read/write/delete SMS from 


SIM and provides functionality of SMS storage/retrieval related to SIM. Telephony provides interfaces 
only for 


accessing SMS SIM memory not the Phone (ME) memory. 


Based on SMS sending/receiving, Telephony FW shall just pass through the SMS PDU received from the 
Messaging FW to 


the OEM and vice-versa. Segmentation/Reassembling of SMS PDUs and handling of User Data header 
and User data is 


the functionality of SMS Plug-in in Messaging FW and shall not be functionality of TAPI library and 
Telephony Server. 


#include "ITapiSim.h" 
#include "tapi, utility.h" 


#include "TapiCommon.h" 


#include "TelNetText.h" 


Functions 


е TapiResult t TelTapiSmsSend (const TelSmsDatapackageInfo_t *pDataPackage, BOOL bMore- 
MsgToSend, int «pRequestId) 


This API is used to send an SMS message to the network. This API interface allows transmitting SMS PDU 
as defined by 3GPP TS 23.040 (SMS-SUBMIT, SMS-COMMAND) to lower layers. This API allows keeping 
the dedicated link at lower layers by passing information as more messages to send in parameters. This will 
enable not to release if a dedicated connection is used for transmission. 


e TapiResult t TelTapiSmsRead (int Index, int «pRequestId) 


This function reads a message from SIM card storage. SIM index (index used when storing the SMS) number 
to be passed to in order to read particular SMS message. Total number of messages can be retrieved by Tel- 
TapiSmsGetCount function. 


е TapiResult t TelTapiSmsWrite (TelSmsMsgStatus_t MsgStatus, const TelSmsDatapackageInfo_- 
t «xpDataPackage, int «pRequestId) 


This function writes a message to SIM storage area. 


e TapiResult t TelTapiSmsDelete (signed short Index, int *pRequestId) 


This function deletes a message specified by index (SIM index used when storing the sms) number from the 
SIM storage area. 
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е TapiResult t TelTapiSmsGetCount (int *pRequestId) 


This function is used to retrieve message count information like Total record count, used record count and 
the indices list for SIM Storage. This is an asynchronous function and the response will be sent back by 
event notification. 


• TapiResult t TelTapiSmsCBSetConfig (const Tel8msCbConfig t *pCBConfig, int xpRequestId) 


This function is used to set SMS CB Message Identifiers in the appropriate EF-CBMI/EF-CBMIR file in 
(U)SIM. This function also indicates underlying provider to enable or disable CB Channel on which CB 
messages are received. 


e TapiResult t TelTapismsCBGetConfig (int *pRequestld) 
This function is used to retrieve SMS CB configuration options from EFcbmi file in the SIM. 


е TapiResult t TelTapiSmsSetSCA (const TelSmsAddressInfo_t жр5СА, int »pRequestId) 


This function is used to set SMS Service Centre Address information in order to send the SMS. 


е TapiResult t TelTapismsGetSCA (TelSmsAddressInfo t *pSCA) 


This function is used to get current SMS Service Centre Address information. 


e TapiResult t TelTapiSmsSetPreferredBearer (TelSmsBearerType t BearerType, int «pRequestId) 


This function is used to set SMS preferred bearer on which SMS has to be transmitted. 


е TapiResult t TelTapiSmsGetPreferredBearer (int *pRequestId) 


This function is used to get SMS preferred bearer on which SMS has to be transmitted. This is an asyn- 
chronous function. 


e TapiResult t TelTapiSmsGetParameters (const int SmsRecordIndex, int »pRequestlId) 


This function is used to get the SMS parameters for a particular SMS (sent/received) based on the SIM index 
where it is stored. This is an asynchronous function. 


• TapiResult t TelTapiSmsSetParameters (const TelSmsParams_t SmsSetParameters, int «pRequest- 
Id) 


This function is used to set the short message service header parameters which are used in the origination 
of MO messages. 


е TapiResult t TelTapiSmsSendDeliveryReport (const TelSmsDatapackageInfo_t *pDataPackage, int 
xpRequestId) 


This function is used to send a delivery report for the received incoming SMS to the network. 
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7.4 ITapiNetwork.h File Reference 


7.4.1 Detailed Description 


This file serves as a "C" header file defines functions for Tapi Network. 


It contains a sample set of function prototypes that would be required by applications. 


#include "TapiCommon.h" 


#include "TelNetwork.h" 


Functions 


е TapiResult t TelTapiNwSetConfiguration (const TelNetworkConfigSettings t *pConfigNetwork- 
Info, int «pRequestId) 


This API allows to set the network configuration settings at OEM based on which network registration will 
happen. 


е TapiResult t TelTapiNwSelectNetwork (const TelNetworkS ystemId t «pSystemlId, int «pRequest- 
Id) 


This function requests the lower layers to select the network (PLMN) which has been selected by the user 
from the Network List displayed to the User. 


e TapiResult t TelTapiNwCancelManualSearch (int «pRequestId) 


This function is called to cancel the triggered manual network search. 


e TapiResult t TelTapiNwCancelManualSelection (int «pRequestId) 


This function is called to cancel manual network selection where user has already selected a network from 
the network list. 


• TapiResult t TelTapiNwGetNetworkInfo (int «pRequestId) 


This function provides an option to get the current network registration status information. 


e TapiResult t TelTapiNwSearchNetwork (int »pRequestId) 


This function sends a request to do manual network selection to search for the available networks and 
provide the Network List to the User/Application. 


* TapiResult t TelTapiNwSetSelectionMode (TelNetworkSelectionMode t NwSelectionMode, int *р- 
RequestId) 
This function is called when user does Automatic or Manual Network Selection. Request for Automatic 


NW selection or Manual NW selection will allow OEM provider to do PLMN Selection based on network 
selection preference. 


e TapiResult t TelTapiNwGetSelectionMode (int «pRequestId) 


This function requests for the present network selection mode i.e. automatic or manual. 


* TapiResult t TelTapiNwSetServiceDomain (TelNetworkServiceDomain t ServiceDomain, int *р- 
RequestId) 


This function is called when User/application wants to configure the service domain to only CS or Only PS 
or Both. This API triggers the underlying protocol stack to do register with Network for only CS services or 
only PS services or both based on the option set using this API. 
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e TapiResult t TelTapiNwSetNetworkOrder (TelNetworkMode t *pPrefNwOrder, int «pRequestId) 


This API allows lower layers to scan based on preferred network order based options passed. 


e TapiResult t TelTapiNwSetNetworkMode (TelNetworkMode t NwMode, int »pRequestId) 


This function allows to configure the Network Mode (Automatic, GSM, WCDMA) at OEM provider based 
on which lower layers can scan only those radio access technologies for registering with network. 


e TapiResult t TelTapiNwSetNetworkBand (TelNetworkBandPreferred t BandMode, TelNetwork- 
Band t Band, int *pRequestId) 


This function is invoked to set the network band and allows the underlying OEM provider to scan the set 
band. 


Generated on Fri Feb 1 01:01:00 2008 by Doxygen 


304 File Documentation 


7.5  ITapiSim.h File Reference 


7.5.1 Detailed Description 


This file serves as a "C" header file defines functions for Tapi SIM Services. 
It contains a sample set of function prototypes that would be required by applications. 


Note: Phonebook APIs are 2G SIM Specific in R1 timeframe. Some Operator may have support only 3G 
Phonebook. 


In this case, 2G SIM Phonebook APIs may return ТАРІ АРІ NOT SUPPORTED as an error value іп 
TapiResult t. 


#include "limo defines.h" 


#include "TapiCommon.h" 


finclude "TelSim.h" 


Functions 


e TapiResult t TelTapiSimGetFileInfo (TelSimFileID t Fileld, int *pRequestId) 


This function is passed to OEM provider in order to fetch the Elementary File info. This functions fetches 
all the Information like Whether EF is present or not, If Present, no of records in EF and EF Data length 
etc. Application can make use this API to know the EF details prior calling SIM Read API. 


e TapiResult t TelTapiSimReadFile (const TelSimReadFileRequestData t *pReadFileReqData, int 
xpRequestId) 


This function is passed to OEM provider in order to read an elementary file. 


е TapiResult t TelTapiSimUpdateFile (const TelSimUpdateFileRequestData t *pUpdateFileReqData, 
int «pRequestId) 


This function is passed to OEM provider in-order to update records in an elementary File. 


e TapiResult t TelTapiSimVerifyPIN (const TelSimPinData t *pPinData, int xpRequestId) 


This function performs PIN verification. This function performs PIN verification based on the pin type 
passed along with pin data. 


e TapiResult t TelTapiSimChangePIN (TelSimPinType t PinType, const char «pOldPinData, const 
char *pNewPinData, int *pRequestId) 


This function changes PIN code based on the pin type passed along with old pin data and new pin data. 


e TapiResult t TelTapiSimDisablePIN (const TelSimPinData t «pPinData, int «pRequestId) 
This function disables the PIN based on the Pin type and pin data passed from Application. 


e TapiResult t TelTapiSimEnablePIN (const TelSimPinData t *рРіпраға, int *pRequestId) 
This function enables the PIN based on the Pin type and pin data passed from the Application. 


e TapiResult t TelTapiSimUnblockPIN (const TelSimPinData t *pPukPinData, const TelSimPin- 
Data t *pNewPinData, int «pRequestlId) 


This function performs unblock PIN operation based on PUK information passed along with unblock infor- 
mation entered by the user. 
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e TapiResult t TelTapiSimDisableFDN (const char «pPinData, int «pRequestId) 
This function disables FDN. 


e TapiResult t TelTapiSimEnableFDN (const char «pPinData, int «pRequestId) 
This function enables FDN. 


• TapiResult t TelTapiSimGetDevCtxdata (TelSimDeviceContext t *pSimData) 


This function is used to get device context data of SIM. SIM device context data such as PIN Enabled 
status, FDN, BDN Status, IMSI information, ECC, LP, (U)SIM service table information, group identifier 
information will be passed. 


е TapiResult t TelTapiSimGetIccIdInfo (TelSimIccIdInfo t «pIccIdInfo) 
This function gets ICC id information. 


e TapiResult t TelTapiSimGetPINStatus (TelSimPinStatus t «pPinStatus, TelSimPinType t жрРіп- 
Type) 
This function gets the current PIN (PIN1 or UPIN) status. 


e TapiResult t TelTapiSimGetPIN2Status (TelSimPinStatus t *pPin2Status) 


This function gets the current Pin2 status. 


e TapiResult t TelTapiSimGetFDNStatus (BOOL *pFdnStatus) 


This function is a synchronous API gets the current FDN status. 


е TapiResult t TelTapiSimGetSstInfo (TelSimSstInfo t «pSimSstInfo) 


This function gets the SIM service table information. 


e TapiResult t TelTapiSimGetUstInfo (TelSimUstInfo t *pSimUstInfo) 


This function gets the USIM service table information. 


e TapiResult t TelTapiSimGetImsiInfo (TelSimImsiInfo t *pSimImsiInfo) 


This function is a synchronous API gets the IMSI information. 


е TapiResult t TelTapiSimGetEccInfo (TelSimEccInfo t *pSimEccInfo, int «pCount) 


This function is a synchronous API used to get ECC data. 


e TapiResult t TelTapiSimGetLanguagePrefInfo (TelSimLanguagelInfo t *pSimLpInfo) 


This API is used to get the language preference information. 


e TapiResult t TelTapiSimGetLanguageIndInfo (TelSimLanguageInfo t *«pSimLiInfo) 


This API is used to get the language indication information. 


e TapiResult t TelTapiSimGetCardType (TelSimCardType t *pCardInfo) 
This function is a synchronous API which gets the Card Type whether SIM Card is a GSM SIM or a 3G SIM. 


е TapiResult t TelTapiSimPBGetStorageCount (TelSimPbFileType t StorageFileType, int «pRequest- 
Id) 


This API is used to get number of used records and total records in SIM phone book files. This API is 
applicable only to GSM phonebook (ADN and EXTI), FDN, SDN, LND and MSISDN. 
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TapiResult t TelTapiSimPBGetEntryInfo (TelSimPbFileType t StorageFileType, int xpRequestId) 
This API is used to get max text length and max number length supported by SIM phone book elementary 


file. 


TapiResult t TelTapiSimPBReadRecord (TelSimPbFileType t StorageFileType, unsigned short In- 
dex, int *pRequestId) 


This API is used to read SIM phone book entry information from given storage type. 


TapiResult t TelTapiSimPBUpdateRecord (const TelSimPbRecordData t «pPbRecordData, int *р- 
RequestId) 


This API is used to add or edit SIM phone book record entry information. 


TapiResult t TelTapiSimPBDeleteRecord (TelSimPbFileType t StorageFileType, unsigned short 
RecordIndex, int *pRequestId) 


This API is used to delete a SIM phone book record. 
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7.6 ITapiSs.h File Reference 


7.6.1 Detailed Description 


This file serves as a "C" header file defines functions for Tapi Supplementary Services. 
It contains a sample set of function prototypes that would be required by applications. 


Note: Supplementary services are dependent on Operator/Market/Vendor. If any of the Supplementary 
Service is 


not supported in underlying telephony provider due to the dependencies, then SS APIs may return an error 


TAPI API NOT SUPPORTED. 


#include "limo defines.h" 


#include "TapiCommon.h" 


#include "TelSs.h" 


Functions 


e TapiResult t TelTapiSsSetCallBarring (const TelSsCallBarringInfo_t «pBarringInfo, int xpRequest- 
Id) 


This function sends a request to activates/deactivates call barring. This service makes it possible for a 
mobile subscriber to activate barring of certain categories of outgoing or incoming calls according to a 
barring program which is selected from a set of one or more barring programs chosen at provision time and 
is valid for all outgoing or incoming calls, or just those associated with a specific basic service group. Also 
this API allows deactivating call barring based on categories set. 


* TapiResult t TelTapiSsGetCallBarringStatus (TelSsCallBarType t BarType, TelSsCallType t Call- 
Type, int «pRequestId) 
This function gets call bar status. The mobile subscriber may determine by subscription of a set of one or 
more unique barring programs what kind of outgoing or incoming calls should be barred. 


e TapiResult t TelTapiSsChangeBarPassword (const char *pOldPassword, const char *pNew- 
Password, int *pRequestId) 


This function allows changing of the barring password in Network. 


e TapiResult t TelTapiSsSetCallForward (const TelSsForwardInfo t *pForwardInfo, int «pRequest- 
Id) 


This function allows to set (register/erase/activate/deactivate) call forwarding option at the Network. This 
enables to forward the calls to another party. This service permits a called mobile subscriber to have the 
network send all incoming calls, or just those associated with a specific Basic service group, addressed 
to the called mobile subscriber's directory number and which meet various call FORWARD condition to 
another directory number. The ability of the served mobile subscriber to originate calls is unaffected. If the 
service is activated, a call is forwarded only if under this call forward condition. Application has to call 
this API in order to explicitly register/erase/activate/deactivate the call forwarding. Request will be passed 
irrespective of whether already another SS call forward is ongoing. 


e TapiResult t TelTapiSsGetCallForwardStatus (TelSsForwardType t Type, TelSsForwardWhen - 
t Condition, int *pRequestId) 


This function provides option to get the call forwarding status of different calls from Network. 
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TapiResult t TelTapiSsSetCall Waiting (BOOL bCwStatus, int *pRequestId) 


This function activates/deactivates the call waiting service. The call waiting service permits a mobile to 
be notified of an incoming call (as per basic call procedures) whilst the traffic channel (BM or LM) is not 
available for the incoming call and the mobile subscriber is engaged in an active or held call. Subsequently, 
the subscriber can accept, reject, or ignore the incoming call. 


TapiResult t TelTapiSsGetCallWaitingStatus (int »pRequestId) 


This function queries the status of call waiting service. The call waiting service permits a mobile to be 
notified of an incoming call (as per basic call procedures) whilst the traffic channel (BM or LM) is not 
available for the incoming call and the mobile subscriber is engaged in an active or held call. Subsequently, 
the subscriber can accept, reject, or ignore the incoming call. 


TapiResult t TelTapiSsVerifyBarPwdResponse (int *»pRequestld, const char «pBarPwdlInfo) 


This API allows Application to provide barring password requested by network for Call Barring Request or 
Change barring password request. 


TapiResult t TelTapiSsSetRestrictCallId (TelSsRestrictIDStatus_t Status) 


This function sets the status of restrict call ID. After set, the phone will show/hide the caller number to the 
called party for all subsequent calls, regardless of type of call. This API assumes user service subscription 
allows changing this setting, sometimes referred to as ‘temporary mode’. If the presentation mode is not 
temporary, the caller of this API will receive an error result. 


TapiResult t TelTapiSsGetRestrictCallId (TelSsRestrictIDStatus t *pStatus) 


This function gets the status of call ID restriction for all subsequent calls. 


TapiResult t TelTapiSsQueryCapabilityInfo (int »pRequestId) 
This API allows Application to query what all SS services are supported at OEM. 


TapiResult t TelTapiUssdSendRequest (const TelSsUssdMsgInfo_t *pAppMsg, int *pRequestId) 


This function is used to send USSD to the Network. The response to the request is a displayable string which 
will be returned to the Application via LiMo EventDelivery. 


TapiResult t TelTapiUssdSendUserResponse (const TelSsUssdMsgInfo t *pAppMsg, int жр- 
RequestId) 


This function is called to send a USSD response provided by the User to the Network for the USSD indication 
received. This contains USSD response type, USSD Indication type and USSD Response data. 
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7.7 "TapiCommon.h File Reference 


7.7.4 Detailed Description 


This file serves as a "C" header file defines functions for Tapi Common Interfaces like Callback Registration 
/ De-registration. 


It contains a sample set of function prototypes that would be required by applications. 


#include "TelUtility.h" 


Data Structures 


* struct TelTapiEvent t 


Typedefs 


e typedef bool(*) TelAppCallback (const TelTapiEvent t *pTapiEvent) 


Enumerations 


* enum TelTapiEventClass t { 


TAPI EVENT NONE = -1, TAPI EVENT CLASS CALL VOICE = 0x00, TAPI EVENT - 
CLASS CALL DATA, TAPI EVENT CLASS NETTEXT, 


TAPI EVENT CLASS NETWORK, TAPI EVENT CLASS SS, TAPI EVENT CLASS SIM, 
TAPI EVENT CLASS ERR, 


TAPI EVENT CLASS UTIL, TAPI EVENT CLASS ALL } 
enum TelTapiEventType t { 


TAPI EVENT CALL SETUP CNF - 1, TAPI EVENT CALL ALERT IND, TAPI EVENT - 
CALL CONNECTING IND, TAPI EVENT CALL CONNECTED IND, 


TAPI EVENT CALL INCOM IND, TAPI EVENT CALL ANSWER CNF, TAPI EVENT - 
CALL RETRIEVE CNF, TAPI EVENT CALL RETRIEVE IND, 


TAPI EVENT CALL HOLD IND, ТАРІ EVENT CALL HOLD CNF, ТАРІ EVENT - 
CALL TRANSFER CNF, TAPI EVENT CALL TRANSFER IND, 


TAPI EVENT CALL SETUPCONFERENCE CNF, TAPI EVENT CALL - 
SETUPCONFERENCE IND, ТАРІ EVENT CALL SPLITCONFERENCE СМЕ, ТАРІ - 
EVENT CALL SEND DTMF СМЕ, 


ТАРІ EVENT САШ, WAITING IND, TAPI EVENT CALL FORWARD IND, TAPI - 
EVENT CALL USERINFO IND, TAPI EVENT CALL RELEASE CNF, 


TAPI EVENT CALL RELEASE ALL CNF, TAPI EVENT CALL END IND, TAPI - 
EVENT NETTEXT READ SMS CNF, TAPI EVENT NETTEXT GET COUNT CNF, 


TAPI EVENT NETTEXT SENTSTATUS СМЕ,  TAPI EVENT МЕТТЕХТ СЕТ PARAM - 
CNF, TAPI EVENT NETTEXT DELETE STATUS CNF, TAPI EVENT NETTEXT SAVE - 
STATUS CNF, 


TAPI EVENT NETTEXT SET REQUEST CNF, TAPI EVENT NETTEXT GET CB - 
CONFIG_CNF, TAPI EVENT NETTEXT GET SMSBEARER CNF, TAPI EVENT - 
NETTEXT DELIVERY REPORT CNF, 
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TAPI EVENT NETTEXT INCOM IND, TAPI EVENT NETTEXT CB INCOM IND, TAPI - 
EVENT NETTEXT MEMORY STATUS IND, TAPI EVENT NETWORK SELECT CNF, 


TAPI EVENT NETWORK SEARCH CNF, TAPI EVENT NETWORK - 
GETSELECTIONMODE CNF, ТАРІ EVENT NETWORK GETNETWORKINFO СМЕ, 
ТАРІ EVENT NETWORK CANCELMANUALSEARCH СМЕ, 


TAPI EVENT NETWORK. CANCELMANUALSELECTION CNF, TAPI EVENT - 
NETWORK SETNWORDER СМЕ, ТАРІ EVENT NETWORK SETNWMODRE СМЕ, ТАРІ - 
EVENT NETWORK SETSELECTIONMODE CNF, 


ТАРІ EVENT NETWORK SETNWBAND СМЕ, TAPI EVENT NETWORK - 
SETSERVICEDOMAIN CNF, TAPI EVENT NETWORK CONFIG CNF, TAPI EVENT - 
NETWORK CHANGE IND, 


ТАРІ EVENT NETWORK SEARCH IND, ТАРІ EVENT NETWORK RADIO INFO IND, 
TAPI EVENT SS BARRING CNF, TAPI EVENT SS BARRING CHANGEPASS CNF, 


TAPI EVENT SS BARRING QUERYSTATUS CNF, TAPI EVENT SS FORWARD CNF, 
TAPI EVENT 55 FORWARD QUERYSTATUS CNF, TAPI EVENT SS WAITING CNF, 


TAPI EVENT SS WAITING QUERYSTATUS CNF, TAPI EVENT SS USSD CNF, TAPI - 
EVENT SS USSDCNF RSP, TAPI EVENT SS USSDCNF NOTIFY, 


TAPI EVENT SS USSD IND RSP, TAPI EVENT SS VERIFY PWD CNF, TAPI EVENT - 
SS QUERYCAPABILITY INFO CNF, TAPI EVENT SS USSD IND, 


TAPI EVENT SS USSD IND NOTIFY, TAPI EVENT SS GET PASSWORD IND, TAPI - 
EVENT SIM FILE INFO CNF, TAPI EVENT SIM READ FILE CNF, 


ТАРІ EVENT SIM UPDATE FILE СМЕ, ТАРІ EVENT SIM VERIFY PIN СМЕ, ТАРІ - 
EVENT SIM CHANGE PIN CNF, TAPI EVENT SIM DISABLE PIN CNF, 


TAPI EVENT SIM ENABLE PIN CNF, TAPI EVENT SIM UNBLOCK PIN CNF, TAPI - 
EVENT SIM DISABLE FDN СМЕ, ТАРІ EVENT SIM ENABLE FDN СМЕ, 


TAPI EVENT SIM PB STORAGE COUNT CNF, TAPI EVENT SIM PB ENTRY INFO - 
CNF, TAPI EVENT SIM PB ACCESS READ CNF, TAPI EVENT SIM PB UPDATE CNF, 


ТАРІ EVENT SIM PB DELETE СМЕ, ТАРІ EVENT SIM STATUS IND, ТАРІ EVENT - 
SIM. FDN. STATUS IND, ТАРІ EVENT ERR. RESERVEDI IND, 


ТАРІ EVENT ERR RESERVED2 IND, ТАРІ EVENT ERR RESERVED3 IND, ТАРІ - 
EVENT ERR КЕЅЕКУЕр4 IND, ТАРІ EVENT ERR RESERVEDS5 IND, 


TAPI EVENT TUNNEL INFO CNF, TAPI EVENT TUNNEL INFO IND } 


Functions 


е TapiResult t TelTapiRegisterClass (TelTapiEventClass t EventClass, unsigned int *pSubscriptionId, 


TelAppCallback AppCb) 


This function is exposed to the TAPI clients to register the callback which needs to be invoked for a particular 
class of Telephony confirmations/indications. If Application tries to call this TelTapiRegisterClass API for 
the same event class multiple times (with same callback or different callback), multiple callback registration 
will happen. SubscriptionID is returned back to the application, if the registration procedure is successful. 
This subscription id needs to be used for de-registering the callback. 


e TapiResult t TelTapiRegisterEvent (TelTapiEventType t EventType, unsigned int «pSubscriptionld, 


TelAppCallback AppCb) 


This function is used to register the callback function for a specific TAPI Event. If Application tries to 
register a callback for a specific event multiple times, then multiple callbacks will be registered. When an 
event indication is received, then registered callbacks for the specific event will be invoked multiple times. 
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e TapiResult t TelTapiDeRegister (unsigned int SubscriptionId) 


This function will de-register the application callback registered for the specific event or event class based 
on the subscription id. This identifier is the same subscription identifier which is returned back to the 
application during TAPI registration procedure. If de-register API is called during any service requests, 
Application registered callback will be cleared based on the subscription id. No application callback shall 
be invoked in case any confirmations/indications are received from TS. 


e TapiResult t TelTapiTunnelReq (const TelTapiTunnelInfo t *pTunnellInfo, int «pRequestId) 
This API allows Application to send any proprietary information to OEM. 


е TapiResult t TelTapiGetVersionInfo (const Tel TapiVersionInfo t *pVersionInfo) 


This function returns the version information of Telephony Server. 
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7.8 TelCall.h File Reference 


7.8.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi Call Services. 


It contains a sample set of constants, enums, structs that would be required by applications. 


Data Structures 


struct TelCallCugInfo t 

struct TelCallingNamelInfo t 
struct TelCallUusInfo t 

struct TelCallSetupParams t 
struct TelCallStatus t 

struct TelCallUserDataInfo t 
struct TelCallEndInfo t 

struct TelCallRedirectionInfo t 
struct TelCallIncomingCallInfo t 


Defines 


• #define ТАРІ CALLING. NAME SIZE MAX 80 
* #define TAPI CALL UUS DATA LEN MAX 131 


Enumerations 


* enum TelCallCause t { 


TAPI CAUSE SUCCESS, TAPI CAUSE ACCESSDISCARD, TAPI CAUSE BARR - 
BYOPERATOR, TAPI CAUSE BEARERMODE NOTIMPL, 


TAPI CAUSE BEARERMODE RESTRICTED, TAPI CAUSE BEARERMODE UNAUTH, 
TAPI CAUSE BEARERMODE UNAVAIL, TAPI CAUSE BUSY, 


TAPI CAUSE CALLMETER EXPIRED, TAPI CAUSE CALLNO ERROR, TAPI CAUSE - 
CKTUNAVAIL, TAPI CAUSE CONGESTION, 


TAPI CAUSE NO CIRCUIT AVAIL, TAPI CAUSE DESTIN INCOMPAT, TAPI CAUSE - 
DTMF NOSPEECH, TAPI CAUSE DTMF REJECTED, 


TAPI CAUSE FACILITY NOTIMPL, TAPI CAUSE FACILITY NOTSUBSCRIBED, TAPI - 
CAUSE INCOMINGCUGCALLS BARRED, TAPI CAUSE INVALNUM, 


TAPI CAUSE MPTY ERROR, TAPI CAUSE NOANSWER, TAPI CAUSE - 
NONCUGMEMBER, TAPI CAUSE NUMBERCHANGED, 
TAPI CAUSE NUMBER ERROR, TAPI CAUSE NWFAILURE, TAPI CAUSE - 


OPERATIONUNAVAIL, TAPI CAUSE OUTOFORDER, 


TAPI CAUSE PROTOCOL ERROR, TAPI CAUSE QOSUNAVAIL, TAPI CAUSE REJECT, 
TAPI CAUSE REJ FAIL, 


ТАРІ CAUSE КЕЈ SRVC NOT АУ, ТАРІ CAUSE REMOTE CKTUNAVAIL, ТАРІ - 
CAUSE RESOURCEUNAVAIL, TAPI CAUSE SERVICEID ERROR, 
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ТАРІ CAUSE SERVICE NOTIMPL, ТАРІ CAUSE SERVICE UNAVAIL, ТАРІ CAUSE - 
MODIFY SAME BEARER, TAPI CAUSE MODIFY NOT PERMITTED, 


TAPI CAUSE HOLD FAIL, TAPI CAUSE TEMPFAILURE, TAPI CAUSE WRONGNUM, 
TAPI CAUSE NORMAL UNSPECIFIED, 


TAPI CAUSE SSERRINVALIDTIVALUE, TAPI CAUSE SSERRINVALIDTI, TAPI CAUSE - 
SSINCOMPATIBLESTATE, TAPI CAUSE SSERRSYNTAXERROR, 


TAPI CAUSE SSPROTOCOLERROR, ТАРІ CAUSE SSNEGATIVEPASSWORDCHECK, 
ТАРІ CAUSE SSSENTASPHASEI, ТАРІ CAUSE SSERROR, 


TAPI CAUSE SS USSD BUSY, TAPI CAUSE IDLE, TAPI CAUSE NETWORK SPECIFIC, 
TAPI CAUSE FADE, 


TAPI CAUSE UNKNOWN, ТАРІ CAUSE INCOM CALL, ТАРІ CAUSE ALERT STOP, 
TAPI CAUSE INTERCEPT, 


TAPI CAUSE REORDER, TAPI CAUSE CLIENT END, TAPI CAUSE ACCESS CLASS - 
BLOCKED, TAPI CAUSE MEMCAPEXCEEDED, 


TAPI CAUSE TYPENOTSUPPORTED, TAPI CAUSE REPLACENOTSUPPORTED, ТАРІ - 
CAUSE PROTOCOLID ERROR, TAPI CAUSE CLASSNOTSUPPORTED, 


TAPI CAUSE DATACODING ERROR, TAPI CAUSE INVAL MSG, TAPI CAUSE CALL - 
BARRED, TAPI CAUSE SIM CALL CONTROL CHANGED TO SS, 


TAPI CAUSE SIM CALL CONTROL CHANGED TO CALL, TAPI CAUSE SIM ERROR, 
TAPI CAUSE SIM CALL CONTROL MODIFIED, TAPI CAUSE RANDOM ACCESS - 
FAILURE, 
TAPI CAUSE LOWER LAYER FAILURE, ТАРІ CAUSE ACCESS REJECTED, ТАРІ - 
CAUSE REEST NOT ALLOWED, TAPI CAUSE EMERGENCY CALL NOT ALLOWED, 


TAPI CAUSE ACCESS NOT ALLOWED, TAPI CAUSE RADIO LINK FAILURE, TAPI - 
CAUSE INVALID IDENTITY, TAPI CAUSE UNKNOWN IDENTITY, 


TAPI CAUSE UNACCEPTABLE IDENTITY, TAPI CAUSE NO SERVICE HERE, TAPI - 
CAUSE SERVICE NOT ALLOWED, TAPI CAUSE SERVICE NOT AVAIL, 


TAPI CAUSE SERVICE NOT WORKING, TAPI CAUSE CANNOT IDENTIFY CALL, 
TAPI CAUSE DEACTIVATION, TAPI CAUSE FATAL ERROR } 

enum TelCallAnswerType t { ТАРІ CALL ANSWER ACCEPT = 0, ТАРІ CALL ANSWER - 
REJECT = 1 } 

enum TelCallType t ( TAPI CALL TYPE VOICE, TAPI CALL TYPE DATA, TAPI CALL - 
TYPE E911 } 

enum TelCallAlertingPattern t { 


ТАРІ CALL ALERTING PATTERN 1 = 0x00, ТАРІ CALL АГЕКТІМС PATTERN 2 = 0x01, 
ТАРІ САШ, ALERTING PATTERN 3 = 0x02, ТАРІ CALL ALERTING PATTERN 4 = 0x03, 


ТАРІ CALL ALERTING PATTERN 5 = 0x04, ТАРІ CALL АГЕКТІМС PATTERN 6 = 0x05, 
ТАРІ CALL ALERTING PATTERN 7 = 0x06, ТАРІ CALL ALERTING PATTERN 8 = 0x07, 


TAPI CALL NO ALERTING PATTERN = 0x08 } 

enum  TelCallActivestate t { ТАРІ CALL CONNECT IDLE, ТАРІ CALL CONNECT - 
ACTIVE, TAPI CALL CONNECT HELD ] 

enum TelCallIdentityMode t ( TAPI CALL IDENTITY DEFAULT, TAPI CALL IDENTITY - 
SHOW, TAPI CALL IDENTITY HIDE } 

enum TelCallCugOptions t { TAPI CALL CUG NO INFO = 0x00, TAPI CALL CUG - 
SUPRESS OA, ТАРІ CALL СОС SUPRESS РКЕ СОС, ТАРІ CALL СОС SUPRESS OA - 
AND ССС) 

enum TelCallUusType t ( TAPI CALL UUS NONE, TAPI CALL UUS 1) 
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* enum TelCallUusProtocolType t { 


TAPI CALL UUS PROTO SPECIFIC = 0, TAPI CALL UUS PROTO OSI HIGHER LAYER 
= 1, ТАРІ CALL UUS PROTO IA5 CHARS = 4, ТАРІ CALL UUS PROTO V120 = 7, 


TAPI CALL UUS PROTO 0931-8) 
enum TelCallNameMode t { ТАРІ CALL NAME AVAIL = 0, ТАРІ CALL NAME - 


RESTRICTED = 1, TAPI CALL NAME UNAVAIL = 2, TAPI CALL NAME AVAIL - 
RESTRICTED = 3] 
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7.9 TelNetText.h File Reference 


7.9.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi Network Text Services. 
It contains a sample set of constants, enums,structs that would be required by applications. 


#include "ITapiSim.h" 


#include "tapi_utility.h" 


#include "TapiCommon.h" 


Data Structures 


struct TelSmsCbConfig_t 

struct TelSmsAddressInfo_t 

struct TelSmsParams_t 

struct TelSmsDatapackagelInfo_t 
struct TelSmsData_t 

struct TelSmsStoredMsgCountInfo_t 
struct TelSmsCbMsg t 


Defines 


#define TAPI NETTEXT CB PAGE SIZE MAX 93 

fdefine TAPI NETTEXT GSM SMS MSG NUM MAX 90 

fdefine TAPI NETTEXT GSM SMS CBMI LIST SIZE MAX 60 

fdefine TAPI NETTEXT SMDATA SIZE MAX 160 

#define TAPI NETTEXT MAX GSM SMS SERVICE CENTER ADDR 12 
#define TAPI NETTEXT MAX INDEX 255 

#define TAPI SIM SMSP ADDRESS LEN 20 

#define TAPI SIM SMSP ALPHA ID LEN MAX 32 


Enumerations 


• enum TelSmsMsgStatus_t { 


TAPI NETTEXT STATUS READ, TAPI NETTEXT STATUS UNREAD, TAPI NETTEXT - 
STATUS SENT, TAPI NETTEXT STATUS UNSENT, 


TAPI NETTEXT STATUS DELIVERED, TAPI NETTEXT STATUS DELIVERY - 
UNCONFIRMED, ТАРІ NETTEXT STATUS MESSAGE REPLACED, ТАРІ NETTEXT - 
STATUS RESERVED } 

enum TelSmsBearerType t ( 


TAPI NETTEXT BEARER PS ONLY - 0x01, TAPI NETTEXT BEARER CS ONLY, TAPI - 
NETTEXT BEARER PS PREFERRED, TAPI NETTEXT BEARER CS PREFERRED, 


TAPI NETTEXT NO PREFERRED BEARER } 

enum TelSmsCbMsgType t { ТАРІ NETTEXT CB MSG CBS = 1, ТАРІ NETTEXT - 
CB MSG SCHEDULE, ТАРІ NETTEXT СВ MSG СВ541, TAPI NETTEXT CB MSG - 
INVALID } 
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enum TelSmsResponse t { 


ТАРІ NETTEXT SENDSMS SUCCESS = 0x00, TAPI NETTEXT ROUTING NOT - 
AVAILABLE, TAPI NETTEXT INVALID PARAMETER, TAPI NETTEXT DEVICE - 
FAILURE, 


ТАРІ NETTEXT SERVICE RESERVED, ТАРІ NETTEXT INVALID LOCATION, ТАРІ - 
NETTEXT NO SIM, TAPI NETTEXT SIM NOT READY, 


TAPI NETTEXT NO NETWORK RESP, TAPI NETTEXT DEST ADDRESS FDN - 
RESTRICTED, ТАРІ NETTEXT SCADDRESS FDN RESTRICTED, ТАРІ NETTEXT - 
RESEND ALREADY DONE, 


TAPI NETTEXT SCADDRESS NOT AVAILABLE, TAPI NETTEXT UNASSIGNED - 
NUMBER, ТАРІ NETTEXT OPERATOR DETERMINED BARRING, ТАРІ NETTEXT - 
CALL BARRED, 


TAPI NETTEXT MESSAGE TRANSFER REJECTED, TAPI NETTEXT MEMORY - 
CAPACITY EXCEEDED, ТАРІ NETTEXT DESTINAITION OUTOFSERVICE, ТАРІ - 
NETTEXT UNSPECIFIED SUBSCRIBER, 


TAPI NETTEXT FACILITY REJECTED, TAPI NETTEXT UNKNOWN SUBSCRIBER, 
TAPI NETTEXT NETWORK. OUTOFORDER, TAPI NETTEXT TEMPORARY FAILURE, 


TAPI NETTEXT CONGESTION, TAPI NETTEXT RESOURCES UNAVAILABLE, 
TAPI NETTEXT FACILITY NOT SUBSCRIBED, TAPI NETTEXT FACILITY NOT - 
IMPLEMENTED, 


TAPI NETTEXT INVALID REF VALUE, TAPI NETTEXT INVALID MSG, TAPI - 
NETTEXT INVALID MANDATORY INFO, TAPI NETTEXT MESSAGE TYPE NOT - 
IMPLEMENTED, 


TAPI NETTEXT MESSAGE NOT COMPAT PROTOCOL, TAPI NETTEXT IE - 
NOT IMPLEMENTED, TAPI NETTEXT PROTOCOL ERROR, TAPI NETTEXT - 
INTERWORKING } 


enum TelSmsCause t { 


ТАРІ NETTEXT SUCCESS, ТАРІ NETTEXT INVALID PARAMETER FORMAT, ТАРІ - 
NETTEXT PHONE FAILURE, TAPI NETTEXT SIM BUSY, 


TAPI NETTEXT SIM FAILURE, TAPI NETTEXT UNKNOWN, TAPI NETTEXT - 
MEMORY FAILURE, TAPI NETTEXT OPERATION NOT SUPPORTED } 
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7.10 TelNetwork.h File Reference 


7.10.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi Network Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelNetworkTimeAndZone t 
struct TelNetworkSystemlId t 
struct TelNetworkConfigSettings t 
struct TelNetworkInfo t 

struct TelNetworkList t 

struct TelNetworkRadioInfo t 


Defines 


• #define ТАРІ NETWORK ORDER MAX 5 

* #define TAPI NETWORK LIST MAX 15 

• #define ТАРІ NETWORK NAME LEN MAX 40 
е #define ТАРІ NETWORK SPN LEN MAX 20 


Enumerations 


e enum TelNetworkSelectionMode t { ТАРІ NETWORK. SELECTIONMODE AUTOMATIC, 
TAPI NETWORK. SELECTIONMODE MANUAL ] 


enum  TelNetworkSystemIdFormat t { TAPI NETWORK SYSID FORMAT SID, ТАРІ - 
NETWORK, SYSID FORMAT PLMN } 


enum TelNetworkServiceDomain t { ТАРІ NETWORK, SERVICE DOMAIN COMBINED, 
ТАРІ NETWORK. SERVICE DOMAIN PS, TAPI NETWORK. SERVICE DOMAIN. CS, 
TAPI NETWORK, SERVICE DOMAIN AUTOMATIC } 


enum TelNetworkMode t ( 

TAPI NETWORK MODE EMERGENCY, TAPI NETWORK. MODE AUTOMATIC, TAPI - 
NETWORK. MODE CDMA, TAPI NETWORK. MODE GSM, 

TAPI NETWORK, MODE WCDMA, TAPI NETWORK, MODE WLAN } 


enum  TelNetworkServiceLevel t { ТАРІ NETWORK SERVICE LEVEL МО, TAPI - 
NETWORK, SERVICE LEVEL EMERGENCY, TAPI NETWORK SERVICE LEVEL FULL, 
ТАРІ NETWORK, SERVICE LEVEL, SEARCH } 


enum TelNetworkServiceType t { 


TAPI NETWORK SERVICE TYPE NO SVE, TAPI NETWORK SERVICE TYPE - 
LIMITED, TAPI NETWORK. SERVICE TYPE CS, TAPI NETWORK SERVICE TYPE PS, 


TAPI NETWORK SERVICE TYPE COMBINED } 
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enum TelNetworkSystemType t { 


ТАРІ NETWORK SYSTEM ХО SRV, TAPI NETWORK. SYSTEM CDMA, TAPI - 
NETWORK, SYSTEM TDMA, ТАРІ NETWORK, SYSTEM GSM, 
ТАРІ NETWORK SYSTEM GPRS, TAPI NETWORK SYSTEM EGPRS, TAPI - 
NETWORK, SYSTEM PCS1900, TAPI NETWORK. SYSTEM UMTS, 
ТАРІ NETWORK, SYSTEM, GSM, AND ОМТ } 
e enum TelNetworkBandPreferred t { ТАРІ NETWORK, BAND MODE PREFERRED = 0x01, 
TAPI NETWORK, BAND MODE ONLY = 0x02 } 
enum TelNetworkBand. t { 


TAPI NETWORK BAND TYPE ANY - 0x00, TAPI NETWORK BAND TYPE GSMS50, 
TAPI NETWORK BAND TYPE GSM 900 1800, TAPI NETWORK BAND TYPE - 
GSM1900, 


ТАРІ NETWORK BAND TYPE GSM, ТАРІ NETWORK BAND TYPE WCDMA, ТАРІ - 
NETWORK, BAND TYPE WCDMAS50, ТАРІ NETWORK BAND TYPE WCDMAI900, 
ТАРІ NETWORK BAND TYPE WCDMA2100 ) 

enum TelNetworkOperationCause t { 


ТАРІ NETWORK NO ERR = 0x00, ТАРІ NETWORK OPERATION FAILED, ТАРІ - 
NETWORK PHONE IN USE ERR, TAPI NETWORK OFFLINE ERR, 


TAPI NETWORK. CONFIG, SETTINGS. FAILURE ERR, ТАРІ NETWORK. INTERNAL - 
FAILURE ERR | 

enum TelNetworkDayLightSavingAdj t { ТАРІ NETWORK. DLS. АП! NO. ADJUSTMENT, 
ТАРІ NETWORK. DLS ADJ PLUS ONE HOUR, ТАРІ NETWORK DLS PLUS TWO - 
HOUR } 
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7.11  TelSim.h File Reference 


7.11.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi SIM Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


#include "limo defines.h" 


#include "TapiCommon.h" 


Data Structures 


struct TelSimFileID t 

struct TelSimPinData t 

struct TelSimReadFileRequestData, t 
struct TelSimIccIdInfo. t 


struct TelSimImsilnfo t 


struct TelSimServiceTable t 
struct TelSimSstInfo t 

struct TelSimPinInfo t 

struct TelSimPb2gData t 
struct TelSimPbRecordData t 
struct TelSimEccInfo t 

struct TelUsimEccInfo t 
struct TelUSimServiceTable t 
struct TelSimUstInfo t 

struct TelSimPbStorageInfo t 
struct TelSimPbEntryInfo t 
struct TelSimPbReadResp t 
struct TelSimPbUpdateResp t 
struct TelSimLanguagelInfo t 
struct TelSimFileAccessGeneralResp t 


struct TelSimGroupldentifierInfo t 
struct TelSimEccData t 

struct TelSimStatusData t 

struct TelSimCallbackEvent t 
struct TelSimEvent t 

struct TelSimApnData t 


struct TelSimDeviceContextData t 


struct TelSimDeviceContext t 

struct TelSimFileInfo t 

struct TelSimReadFileData t 

struct TelSimUpdateFileRequestData t 
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Defines 


fdefine TAPI SIM PIN LENGTH 8 

#define TAPI SIM ICCIDLENGTH 10 

#define TAPI SIM ICCID PACKET LEN 10 

#define TAPI SIM ICCID MAX LEN 10 

#define TAPI SIM LP MAX LEN 30 

#define TAPI SIM LP PACKET MAX LEN 30 

#define ТАРІ SIM IMSI LEN 8 

#define TAPI SIM IMSI PACKET LEN 15 

#define ТАРІ SIM MCC CODE LEN 3 

#define TAPI SIM MNC CODE LEN 2 

#define TAPI SIM MSIN CODE LEN 10 

#define TAPI SIM NUM TEXT MAX LEN 256 

#define TAPI SIM SST MAX LEN 20 

#define TAPI SIM GSM SST SERVICE MAX COUNT 50 
fdefine TAPI SIM ECC CODE LEN 3 

fdefine TAPI SIM ECC ALPHA STRING LEN MAX 50 
#define ТАРІ TAPI SIM PBOOK ENTRY COUNT MAX 20 
fdefine TAPI SIM LI MAX LEN 30 

fdefine TAPI SIM LI PACKET MAX LEN 30 

#define TAPI SIM ACL MAX LEN 50 

#define TAPI SIM GROUP IDENTIFIER LEN MAX 10 
#define TAPI SIM ECC MAX LEN 15 

#define ТАРІ SIM UECC RECORD COUNT МАХ 5 
fdefine TAPI SIM UECC RECORD LEN MAX 50 


Enumerations 


enum TelSimCardType t ( TAPI SIM CARD TYPE UNKNOWN, TAPI SIM CARD TYPE - 
GSM, TAPI SIM CARD TYPE USIM } 

enum TelSimFileName t { 

TAPI SIM EFILE DIR = Ox2F00, TAPI SIM EFILE ICCID = Ox2FE2, TAPI SIM EFILE - 
ADN = 0x6F3A, ТАРІ SIM, EFILE FDN = 0x6F3B, 

TAPI SIM EFILE SMS = 0x6F3C, ТАРІ SIM. ЕЕП,Е CCP = 0x6F3D, ТАРІ SIM. ЕЕП,Е IMSI 
= 0х6Е07, ТАРІ SIM EFILE, SST = Ox6F38, 

TAPI SIM EFILE EST = 0х6Е56, ТАРІ SIM EFILE АСМ = 0х6Е39, TAPI SIM EFILE - 
MBDN = 0x6FC7, TAPI SIM  EFILE GIDI = Ox6F3E, 

TAPI SIM EFILE GID2 = Ox6F3F, TAPI SIM. EFILE. MSISDN = 0x6F40, TAPI SIM. EFILE - 
SMSP = 0x6F42, ТАРІ SIM EFILE, SMSS = Ox6F43, 

ТАРІ SIM EFILE ЕХТІ = 0x6F4A, TAPI SIM. ЕЕП,Е EXT2 = 0х6ҒАВ, TAPI SIM. EFILE LP 
= Ox2F05, ТАРІ SIM EFILE, ACM. MAX = 0x6F37, 

TAPI SIM EFILE РОСТ = 0х6Е41, ТАРІ SIM EFILE. CBMI = Ox6F45, ТАРІ SIM EFILE - 
PHASE = Ox6FAE, TAPI SIM. EFILE. SDN = Ox6F49, 

ТАРІ SIM EFILE EXT3 = 0x6F4C, ТАРІ SIM, EFILE BDN = 0х6ҒАр, ТАРІ SIM EFILE - 
EXTA = Ox6F4E, TAPI SIM, EFILE, ECC = 0x6FB7, 


TAPI SIM EFILE SPN = Ox6F46, ТАРІ SIM ЕЕП Е РММ = Ox6FC5, ТАРІ SIM EFILE IMG 
= Ox4F20, ТАРІ SIM EFILE USIM LI = 0x6F05, 
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ТАРІ SIM EFILE USIM IMSI = 0x6A07, ТАРІ SIM. EFILE USIM АСМ MAX = 0x6A37, 
TAPI SIM. EFILE USIM UST = 0x6A38, ТАРІ SIM EFILE USIM ACM = 0x6A39, 


TAPI SIM EFILE USIM SPN - 0x6A46, TAPI SIM EFILE USIM PUCT - 0x6A41, TAPI - 
SIM. EFILE USIM CBMI = 0x6A45, ТАРІ SIM EFILE USIM ECC = 0x6AB7, 


TAPI SIM EFILE USIM FDN = 0x6A3B, ТАРІ SIM EFILE USIM SMS = 0x6A3C, ТАРІ - 
SIM. EFILE USIM MSISDN = 0x6A40, ТАРІ SIM EFILE (ЗІМ SMSP = 0x6A42, 


TAPI SIM EFILE USIM SMSS = 0x6A43, ТАРІ SIM EFILE USIM SDN = 0x6A49, ТАРІ - 
SIM. EFILE USIM EXTI = 0X6A4A, ТАРІ SIM EFILE USIM EXT? = 0x6A4B, 


TAPI SIM EFILE USIM EXT3 = 0x6A4C, ТАРІ SIM ЕЕП Е USIM EXTA = 0x6A55, ТАРІ - 
SIM EFILE USIM ЕХТ5- 0x6A4E, ТАРІ SIM EFILE USIM ЕХТ6- 0x6FC8, 


ТАРІ SIM EFILE USIM CCP2 = Ox6A4F, ТАРІ SIM EFILE USIM HIDDEN KEY = 
Ox6FC3, ТАРІ SIM EFILE USIM BDN = 0х6А4р, ТАРІ SIM EFILE USIM MBDN 
Ox6FC7, 


ТАРІ SIM EFILE USIM MBI = 0x6FC9, ТАРІ SIM EFILE USIM РНОМЕВООК РВК = 
Ox4FFO, ТАРІ SIM EFILE USIM РНОМЕВООК ССРІ = Ox4FFE, ТАРІ SIM EFILE USIM - 
PHONEBOOK UID = 0x4FF8, 


TAPI SIM EFILE USIM PHONEBOOK PSC =  Ox4FFEB ТАРІ SIM EFILE ОІМ - 
PHONEBOOK CC = Ox4FEF, ТАРІ SIM EFILE USIM PHONEBOOK PUID = Ox4FEE, 
ТАРІ SIM. EFILE USIM PHONEBOOK ADN = 0x4FF1, 


TAPI SIM EFILE USIM PHONEBOOK ТАР =  Ox4FF2, TAPI SIM EFILE USIM - 
РНОМЕВООК РВС = 0х4ЕЕЗ, ТАРІ SIM EFILE USIM РНОМЕВООК ЕХТІ = Ox4FFB, 
ТАРІ SIM. EFILE USIM РНОМЕВООК СКР = Ox4FF7, 


TAPI SIM EFILE USIM PHONEBOOK AAS =  Ox4FFC, ТАРІ SIM EFILE USIM - 
PHONEBOOK_AAS1 = Ox4FFD, ТАРІ SIM EFILE USIM PHONEBOOK GAS = Ox4FOE, 
TAPI SIM. EFILE USIM PHONEBOOK GASI = Ox4FOF, 


ТАРІ SIM EFILE USIM PHONEBOOK АМК =  Ox4FF4, TAPI SIM EFILE USIM - 
PHONEBOOK SNE = Ox4FF9, ТАРІ SIM EFILE USIM PHONEBOOK EMAIL = Ox4FFA, 
TAPI SIM EFILE USIM PHONEBOOK ANRA = Ox4F13, 


TAPI SIM EFILE USIM PHONEBOOK ANRB = 0х4Е14, ТАРІ SIM EFILE USIM - 
РНОМЕВООК ANRC = Ox4F15, ТАРІ SIM EFILE USIM РНОМЕВООК ANRI = Ox4F16, 
TAPI SIM. EFILE USIM PHONEBOOK ANRAI = 0x4F17, 


ТАРІ SIM EFILE USIM PHONEBOOK АМКВІ = Ox4F18, ТАРІ SIM EFILE USIM - 
РНОМЕВООК ANRCI = Ox4F21, ТАРІ SIM EFILE USIM РНОМЕВООК ADNI = Ox4F1A, 
ТАРІ SIM. EFILE USIM PHONEBOOK РВСІ = 0x4F1B, 


TAPI SIM EFILE USIM РНОМЕВООК СЕРІ =  Ox4FIC, ТАРІ SIM EFILE USIM - 
РНОМЕВООК SNEI! = Ox4FID, ТАРІ SIM EFILE USIM PHONEBOOK UIDI = Ox4FIE, 
ТАРІ SIM EFILE USIM РНОМЕВООК EMAILI = Ox4F1F, 


TAPI SIM EFILE USIM PHONEBOOK ТАРІ = 0х4ЕЕ5, ТАРІ SIM EFILE TELECOM - 
PHONEBOOK PBR = 0x4F30, TAPI SIM EFILE TELECOM РНОМЕВООК РВКІ = 0x4F29, 
ТАРІ SIM EFILE TELECOM PHONEBOOK РВК2 = 0x4F28, 


ТАРІ SIM EFILE TELECOM PHONEBOOK CCP] =  Ox4F3D, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK UID = Ox4F00, TAPI SIM EFILE TELECOM PHONEBOOK PSC 
= Ox4F22, ТАРІ SIM EFILE TELECOM PHONEBOOK CC = 0x4F23, 


ТАРІ SIM EFILE TELECOM PHONEBOOK PUID = 0х4Е24, TAPI SIM EFILE - 
TELECOM PHONEBOOK ADN = 0x4F3A, TAPI SIM EFILE TELECOM PHONEBOOK - 
ТАР = 0х4Е25, TAPI SIM EFILE TELECOM PHONEBOOK PBC = 0x4F09, 


TAPI SIM EFILE TELECOM PHONEBOOK EXTI =  Ox4F4A, ТАРІ SIM EFILE - 
TELECOM PHONEBOOK GRP = 0х4Е26, TAPI SIM EFILE TELECOM PHONEBOOK - 
AAS = 0x4F4B, ТАРІ SIM EFILE TELECOM PHONEBOOK GAS = 0x4F4C, 
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ТАРІ SIM EFILE TELECOM PHONEBOOK АМА =  Ox4Fll, TAPI SIM EFILE - 
TELECOM PHONEBOOK SNE = 0x4F19, ТАРІ SIM EFILE TELECOM PHONEBOOK - 
EMAIL = Ox4F50, ТАРІ SIM EFILE TELECOM PHONEBOOK ANRA = 0x4F31, 


ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB =  Ox4F32, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ANRC = Ox4F40, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
ANRI = Ox4F33, ТАРІ SIM EFILE TELECOM, РНОМЕВООК ANRAI = 0x4F34, 
ТАРІ SIM EFILE TELECOM PHONEBOOK ANRB1 =  Ox4F35, TAPI SIM EFILE - 
TELECOM РНОМЕВООК ADNI = Ox4F36, ТАРІ SIM EFILE TELECOM, PHONEBOOK - 
РВСІ = Ox4F37, TAPI SIM EFILE TELECOM. РНОМЕВООК СЕРІ = 0x4F38, 
ТАРІ SIM EFILE TELECOM PHONEBOOK SNEI = Ox4F39, ТАРІ SIM. EFILE - 
TELECOM РНОМЕВООК UID1 = Ox4F3B, ТАРІ SIM EFILE TELECOM. PHONEBOOK - 
EMAIL] = 0x4F3C, ТАРІ SIM EFILE TELECOM, PHONEBOOK ТАРІ = Ox4F3E, 

TAPI SIM EFILE MSG WAITING INDICATION STATUS =  0x6FCA, ТАРІ SIM - 
EFILE INVALID = OxFFFF, ТАРІ SIM EFILE, OTHERS } 

enum TelSimFileType t { 

TAPI SIM FTYPE DEDICATED - 0x00, TAPI SIM FTYPE TRANSPARENT - 0x01, TAPI - 
SIM. FTYPE LINEAR FIXED - 0x02, TAPI SIM FTYPE CYCLIC - 0x04, 

ТАРІ SIM, FTYPE INVALID TYPE = OxFF } 

enum TelSimRecordMode t ( 

TAPI SIM. RECORD NONE = 0x00, TAPI SIM RECORD ABSOLUTE = 0x01, TAPI SIM - 
RECORD. CURRENT = 0x02, TAPI SIM. RECORD NEXT = 0x03, 

TAPI SIM RECORD PREVIOUS = 0x04, TAPI SIM, RECORD TO THE LAST = 0x05, 
TAPI SIM RECORD FROM, THE FIRST - 0x06 } 

enum TelSimPinStatus t { 

TAPI SIM. PIN STATUS DISABLED = 0x00, ТАРІ SIM PIN STATUS ENABLED = 0x01, 
TAPI SIM. PIN STATUS BLOCKED = 0x02, ТАРІ SIM. PIN STATUS РОК BLOCKED = 
0x03, 
ТАРІ SIM PIN STATUS UNKNOWN = OxFF } 

enum TelSimPinOperationResult t { 

TAPI SIM. PIN OPERATION SUCCESS, ТАРІ SIM, BUSY STATUS, ТАРІ SIM. CARD - 
ERROR, STATUS, TAPI SIM, INCOMPATIBLE PIN. OPERATION STATUS, 

TAPI SIM. PIN ІМСОККЕСТ PASSWORD STATUS, TAPI SIM. PIN2 REQD STATUS, 
TAPI SIM. PIN2 INCORRECT PASSWORD STATUS, ТАРІ SIM. РОК INCORRECT. - 
PASSWORD STATUS, 

ТАРІ SIM. РОК REQD STATUS, ТАРІ SIM, PUK2 REQD STATUS ) 

enum TelSimAccessResult_t ( 

TAPI SIM. ACCESS. SUCCESS, ТАРІ SIM. ACCESS CARD ERROR, ТАРІ SIM, ACCESS - 
FILE NOT. FOUND, TAPI SIM ACCESS ACCESS CONDITION МОТ SATISFIED, 

TAPI SIM. ACCESS FAILED } 

enum TelSimPinType t { 

TAPI SIM PTYPE РІМІ = 0x00, ТАРІ SIM. PTYPE PIN2 = 0x01, ТАРІ SIM PTYPE РОКІ = 
0x02, ТАРІ SIM. PTYPE РОК2 = 0x03, 

TAPI SIM, PTYPE UPIN = 0x04, TAPI SIM PTYPE ADM = 0x05 } 

enum TelSimTypeOfNum t { 

TAPI SIM TON UNKNOWN = 0, TAPI SIM TON INTERNATIONAL = 1, TAPI SIM TON - 
NATIONAL = 2, ТАРІ SIM, TON. NETWORK, SPECIFIC = 3, 

TAPI SIM TON DEDICATED ACCESS = 4, ТАРІ SIM, TON. ALPHA, NUMERIC - 5, TAPI - 
SIM, TON ABBREVIATED NUMBER = 6, ТАРІ SIM TON RESERVED FOR EXT 27] 
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enum  TelSimTextEncrypt t { ТАРІ SIM TEXT ЕМС ASCIL ТАРІ SIM TEXT ENC - 
GSM7BIT, ТАРІ SIM TEXT ЕМС UCS2, ТАРІ SIM TEXT ЕМС HEX } 
enum TelSimPbFileType t { 


TAPI SIM PB FDN, TAPI SIM PB LDN, TAPI SIM PB MSISDN, TAPI SIM PB ADN, 


TAPI SIM PB SDN } 

enum TelSimPbAccessMode t { TAPI SIM PB ACCESS MODE ADD = 0x01, TAPI SIM - 
PB ACCESS MODE DEL = 0x02, ТАРІ SIM PB ACCESS МОРЕ EDIT = 0x03 } 

enum TelSimNumberingPlanIdentity_t { 

TAPI SIM NPI UNKNOWN = 0, TAPI SIM NPI ISDN TEL = 1, TAPI SIM NPI DATA - 
NUMBERING PLAN = 3, ТАРІ SIM NPI TELEX = 4, 

TAPI SIM NPI SVC CNTR SPECIFIC PLAN - 5, TAPI SIM NPI SVC CNTR SPECIFIC - 
PLAN? = 6, ТАРІ SIM NPI NATIONAL = 8, ТАРІ SIM NPI PRIVATE = 9, 

TAPI SIM NPI ERMES NUMBERING PLAN = 10, TAPI SIM NPI RESERVED FOR EXT 
= OxF } 

enum TelSimEccEmergencyServiceInfo t { 

TAPI SIM ECC ESC POLICE = 0x01, TAPI SIM ECC ESC AMBULANCE = 0x02, TAPI - 
SIM. ECC ESC FIREBRIGADE = 0x03, TAPI SIM ECC ESC MARAINEGUARD = 0x04, 
TAPI SIM ECC ESC MOUTAINRESCUE = 0x05, TAPI SIM ECC ESC SPARE = 0x00 } 
enum TelSimPbAccessResult. t ( 

TAPI SIM PB SUCCESS, TAPI SIM PB FAIL, TAPI SIM PB INVALID INDEX, TAPI - 
SIM PB INVALID NUMBER LENGTH, 

TAPI SIM PB INVALID NAME LENGTH, ТАРІ SIM PB ACCESS CONDITION NOT - 
SATISFIED } 

enum TelSimLangIndicationCode_t { 

TAPI SIM LI GERMAN = 0, TAPI SIM LI ENGLISH = 0x01, TAPI SIM LI ITALIAN = 
0x02, ТАРІ SIM LI FRENCH = 0x03, 

TAPI SIM LI SPANISH = 0x04, TAPI SIM LI DUTCH = 0x05, TAPI SIM LI SWEDISH = 
0x06, ТАРІ SIM. LI DANISH = 0x07, 

TAPI SIM LI PORTUGUESE = 0x08, TAPI SIM LI FINNISH = 0x09, TAPI SIM LI - 
NORWEGIAN = 0x0A, ТАРІ SIM LI GREEK = OxOB, 

TAPI SIM LI TURKISH = 0х0С, TAPI SIM LI HUNGARIAN 
POLISH = OxOE, ТАРІ SIM LI LANG UNSPECIFIED = 0x0F } 
enum TelSimAccessType t { 

TAPI SIM. SELECT, TAPI SIM READ BINARY, TAPI SIM READ RECORD, TAPI SIM - 
GET RESPONSE, 

TAPI SIM UPDATE BINARY, TAPI SIM UPDATE RECORD, TAPI SIM STATUS } 

enum TelSimCardStatus t { 

TAPI SIM STATUS CARD ERROR = 0x00, TAPI SIM STATUS CARD NOT PRESENT = 
0x01, TAPI SIM STATUS SIM INITIALIZING = 0x02, TAPI SIM. STATUS SIM INIT - 
COMPLETED = 0x03, 

ТАРІ SIM STATUS SIM PIN REQUIRED = 0x04, ТАРІ SIM STATUS SIM РОК - 
REQUIRED = 0x05, TAPI SIM STATUS CARD BLOCKED = 0x06 } 

enum TelSimAcl t ( 

TAPI SIM ACL ALW = 0x00, TAPI SIM ACL PINI = 0x01, TAPI SIM ACL PIN2 = 0x02, 
ТАРІ SIM. ACL RFU = 0x04, 


ТАРІ SIM ACL ADM = 0x08, ТАРІ SIM ACL NEVER = OxFF } 


OxOD, TAPI SIM LI - 
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7.12 TelSs.h File Reference 


7.12.1 Detailed Description 


This file serves as a "C" header file defines structures for Tapi SS Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


struct TelSsForwardInfo t 

struct TelSsUssdMsglInfo t 
struct TelSsCallBarringInfo t 
struct TelSsCliRecord t 

struct TelSsCallBarringRecord t 
struct TelSsForwardRecord_t 
struct TelSsCallWaitingRecord t 
union TelSsRecord t 

struct TelSsInfo t 

struct TelSsCapabilityInfo t 


Defines 


• #define ТАРІ SS С5М BARR PW LEN MAX 4 
• #define ТАРІ CALL DIALDIGIT LEN MAX 82 
* #define TAPI SS USSD DATA SIZE MAX 201 


Enumerations 


* enum TelSsForwardWhen t ( 


TAPI SS FORWARD WHEN UNCONDITIONAL EV, TAPI SS FORWARD WHEN - 
BUSY EV, TAPI SS FORWARD WHEN NO ANSWER EV, TAPI SS FORWARD WHEN - 
NOT REACHABLE EV, 

TAPI SS FORWARD WHEN ALL FORWARDING EV } 

enum TelSsCallBarType t { 


TAPI CALL BARRING ALL, ТАРІ CALL ВАККІМС OUTGOING, TAPI CALL - 


БАККІМС ALL OUTGOING. CALLS, TAPI CALL BARRING ALL OUTGOING - 
INTERN CALL, 
TAPI CALL BARRING ALL OUTGOING INTERN CALL EXCEPT, TAPI CALL - 


BARRING INCOMING, TAPI CALL BARRING ALL INCOMING CALLS, TAPI CALL - 
ВАВВІЧС ALL INCOMING CALLS. ROAMING, 

ТАРІ CALL BARRING. ALL INCOMING.  CALLS INSIM } 

enum TelSsTeleService t { 

ТАРІ SS TS ALL TELE AND BEARER SERVICES, ТАРІ SS TS ALL TELESERVICES, 
ТАРІ SS TS АШ, SPEECH, ТАРІ SS TS ALL DATA TELESERVICES, 


TAPI SS TS FACS, ТАРІ SS TS ALL TELESERVICES EXCEPT SMS, ТАРІ SS TS - 
ALL PLMN SPEC TELE, TAPI SS TS PLMN SPEC TELE 1, 
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ТАРІ SS TS PLMN SPEC TELE 2, ТАРІ SS TS PLMN SPEC TELE 3, ТАРІ SS TS - 
PLMN SPEC TELE 4, TAPI SS TS PLMN SPEC TELE 5, 

TAPI SS TS PLMN SPEC TELE 6, TAPI SS TS PLMN SPEC TELE 7, TAPI SS TS - 
PLMN SPEC TELE 8, TAPI SS TS PLMN SPEC TELE 9, 

TAPI SS TS PLMN SPEC TELE A, TAPI SS TS PLMN SPEC TELE B, TAPI SS TS - 
PLMN SPEC TELE C, TAPI SS TS PLMN SPEC TELE D, 

TAPI SS TS PLMN SPEC TELE E, TAPI SS TS PLMN SPEC TELE F, TAPI SS TS - 
PLMN SPEC TELE , TAPI SS BS ALL BEARER SERVICES, 

TAPI SS BS ALL DATA CDS, TAPI SS В5 ALL ASYNCHRONOUS, TAPI SS BS ALL - 
SYNCHRONOUS, TAPI SS BS DATA CIRCUIT SYNC, 

TAPI SS BS DATA CIRCUIT ASYNC, TAPI SS BS DATA ALL PDS, TAPI SS BS ALL - 
DATA. PADCA, ТАРІ SS BS ALL PLMN SPEC BS, 

TAPI SS BS PLMN SPEC TELE 1, TAPI SS BS PLMN SPEC TELE 2, ТАРІ SS BS - 
PLMN SPEC TELE 3, TAPI SS BS PLMN SPEC TELE 4, 

TAPI SS BS PLMN SPEC TELE 5, TAPI SS BS PLMN SPEC TELE 6, TAPI SS BS - 
PLMN SPEC TELE 7, TAPI SS BS PLMN SPEC TELE 8, 

TAPI SS BS PLMN SPEC TELE 9, TAPI SS BS PLMN SPEC TELE A, TAPI SS BS - 
PLMN SPEC TELE B, TAPI SS BS PLMN SPEC TELE C, 

TAPI SS BS PLMN SPEC TELE D, TAPI SS BS PLMN SPEC TELE E, TAPI SS BS - 
PLMN SPEC TELE F, TAPI SS TS ALL DATA, 

TAPI SS TS DATA CIRCUIT SYNC, TAPI SS TS MULTIPLE, TAPI SS TS TELEPHONY, 
TAPI SS TS DATA CIRCUIT ASYNC, 

TAPI SS TS DATA PACKET } 

enum TelSsUssdRespType t { TAPI USSD RES UNKNOWN ALPHABET, TAPI USSD - 
RES DISPL BUSY, ТАРІ USSD RES OK, ТАРІ USSD RES NONE } 

enum TelSsUssdIndType t ( 

ТАРІ USSD IND NOTIFY = 0x00, ТАРІ USSD IND NO ACTION REQUIRE = 0x01, ТАРІ - 
USSD IND. ACTION REQUIRE = 0x02, ТАРІ USSD IND TERMINATED BY NET = 0x03, 
ТАРІ USSD IND OTHER CLIENT = 0x04, ТАРІ USSD IND МОТ SUPPORT = 0x05, ТАРІ - 
USSD IND TIME OUT - 0x06 ] 

enum TelSsCallBarOperationMode t { TAPI SS CALL BAR ACTIVATE, TAPI SS CALL - 
ВАК DEACTIVATE } 

enum TelSsCallType t { 

TAPI CALL TYPE VOICE EV, TAPI CALL TYPE DATA EV, TAPI CALL TYPE FAX - 
EV, TAPI CALL TYPE SHORT MESS EV, 

ТАРІ CALL ТҮРЕ DATA CIRCUIT SYNC ЕУ) 

enum TelSsForwardMode t ( TAPI CALL FORWARD MODE DISABLE EV, TAPI CALL - 
FORWARD MODE ENABLE EV,  TAPI CALL FORWARD MODE REGISTRATION EV, 
TAPI CALL FORWARD MODE ERASURE EV } 

enum TelSsForwardType t { ТАРІ CS FORWARD ТҮРЕ VOICE EV = 0, ТАРІ CS - 
FORWARD TYPE DATA EV, ТАРІ CS FORWARD TYPE FAX ЕУ) 


enum  TelSsRestrictIDStatus t { ТАРІ CALL RESTRICT ID DEPEND NETWORK EV, 
ТАРІ CALL RESTRICT ID ENABLE EV, ТАРІ CALL RESTRICT ID DISABLE ЕУ) 


enum TelSsType t { 


TAPI 55 TYPE BARRING, TAPI 55 TYPE FORWARDING, ТАРІ 55 TYPE WAITING, 
TAPI SS TYPE IDENTIFICATION, 


ТАРІ SS TYPE СМАР, ТҮРЕ SS TYPE USSD } 
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enum TelSsCause t ( 


TAPI SS SUCCESS, TAPI SS TIMEREXPIRE, TAPI SS UNKNOWNSUBSCRIBER, TAPI - 
SS SERVICENOTPROVISIONED, 


TAPI SS CALLBARRED, TAPI SS ILLEGALSSOPERATION ERROR, TAPI SS - 
NOTAVAILABLE, ТАРІ 55 SUBSCRIPTIONVIOLATION, 


TAPI SS FACILITYNOTSUPPORTED, TAPI SS UNEXPECTEDDATAVALUE, ТАРІ SS - 
PWREGISTRATIONFAILURE, ТАРІ 55 NEGATIVEPWCHECK, 


TAPI SS NUMBEROFPWATTEMPTSVIOLATION, TAPI SS UNKNOWNALPHABET, 
ТАРІ 55 USSDBUSY, ТАРІ 55 REJECTEDBYUSER, 


ТАРІ 55 REJECTEDBYNETWORK, ТАРІ SS INVALIDDEFLECTEDTONUMBER, ТАРІ - 
SS MAXNOMPTYEXCEEDED, TAPI SS RESOURCESNOTAVAILABLE, 


TAPI SS UNKNOWNERROR, TAPI SS OEM, NOT SUPPORTED } 
enum TelSsStatus t ( 


TAPI SS STATUS ACTIVE, TAPI SS STATUS REGISTERED, TAPI SS STATUS - 
PROVISIONED, TAPI SS STATUS QUIESCENT, 


TAPI SS STATUS NOTHING } 
enum TelSsLineldentificationType t { 


ТАРІ CALLING LINE IDENTITY PRESENTATION, ТАРІ CALLING LINE IDENTITY - 


RESTRICTION, TAPI CONNECTED LINE IDENTITY PRESENTATION, TAPI - 
CONNECTED LINE IDENTITY RESTRICTION, 

TAPI CALLED LINE IDENTITY PRESENTATION, ТАРІ CALLING. NAME - 
PRESENTATION } 


enum TelSsCliStatus t { 


TAPI CLI STATUS NOT PROVISONED, TAPI CLI STATUS PROVISIONED, TAPI CLI - 
STATUS ACTIVATED, TAPI CLI STATUS UNKOWN, 
TAPI CLI STATUS TEMP RESTRICTED, TAPI CLI STATUS TEMP ALLOWED ] 


enum TelSsBarPwdType t ( TAPI SS ВАК GET PWD, TAPI SS BAR NEW PWD, TAPI - 
SS ВАК VERIFY NEW PWD] 
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7.13  TelUtility.h File Reference 


7.13.1 Detailed Description 


This file serves as a "C" header file defines structures for Utility Services. 


It contains a sample set of constants, enums,structs that would be required by applications. 


Data Structures 


* struct TelTapiVersionInfo t 
* struct TelTapiTunnelInfo t 
* struct TelTapiErrorInfo t 


Enumerations 


* enum TapiResult t { 


TAPI API SUCCESS, TAPI API INVALID INPUT, TAPI API INVALID PTR, TAPI API - 
INVALID САШ, STATE, 


TAPI API NOT SUPPORTED, ТАРІ АРІ DEPRICATED, ТАРІ АРІ SYSTEM OUT OF - 
MEM, ТАРІ АРІ SYSTEM RPC LINK. DOWN, 


ТАРІ АРІ MODEM POWERED OFF, ТАРІ АРІ SERVICE NOT READY, ТАРІ АРІ - 
SERVER FAILURE, ТАРІ АРІ ОЕМ PLUGIN FAILURE, 


TAPI API INVALID CALL HANDLE, TAPI API INVALID DATA LEN, TAPI API SIM - 
NOT FOUND, TAPI API SIM BUSY, 


TAPI API SIM INVALID CARD TYPE, TAPI API SIM CARD PERMANENT ERROR, 
TAPI API SIM NOT INITIALIZED, TAPI API REQUEST MAX IN PROGRESS, 


TAPI API OFFLINE MODE ERROR, TAPI EVENT CLASS UNKNOWN, TAPI EVENT - 
UNKNOWN, TAPI REGISTRATION FAILURE } 
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